Skip to content

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 --pretty

Expected 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 key

Check 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 --version

Notes

  • 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.