Appearance
Test
Status: NEEDS-ACCOUNT
Classification: NEEDS-ACCOUNT (cloud API) Install method: pip (pip install tinyfish) for the Python SDK and CLI. No standalone npm package found. Cost tier: Credit-based. Free credits may be available at signup. See tinyfish.ai for current pricing. What is required: An account at tinyfish.ai and a valid API key (TINYFISH_API_KEY). All browser agent runs execute in TinyFish cloud.
Smoke Test - CLI
After installing the CLI and setting TINYFISH_API_KEY, run:
bash
tinyfish agent run "Extract the first 2 product names and prices" \
--url https://scrapeme.live/shop --prettyExpected success output:
json
{
"products": [
{ "name": "Bulbasaur", "price": "£63.00" },
{ "name": "Ivysaur", "price": "£87.00" }
]
}The exact names and prices on scrapeme.live may vary, but the shape (a JSON object with a products array) is the signal. A clean JSON response with no error field means the agent authenticated, navigated, and extracted successfully.
Verify API Key Is Wired
A missing or invalid key returns an HTTP 401 with a JSON error body. If you see:
Error: 401 Unauthorized - invalid API keyCheck that TINYFISH_API_KEY is exported in the current shell session and matches the key shown in your TinyFish dashboard.
SDK Version Check
bash
# Python
pip show tinyfish
# Node CLI
tinyfish --versionNotes
- The CLI smoke test above consumes agent credits (1 credit per step). Use the free Search or Fetch API for zero-cost connectivity checks.
- The scrapeme.live shop is a public test store maintained for scraper demos; it is safe to target in tests.
- Agent and Browser usage caps at 100 concurrent run IDs per bulk request. Smoke tests are single-run and unaffected.