Agent skill

Use Tinyfish

by tinyfish-io in tinyfish-io/tinyfish-cookbook

Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation.

MITAuto-check passedProductivity & Automation

Install Use Tinyfish

skills CLI
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfish --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/use-tinyfish .claude/skills/use-tinyfish && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
use-tinyfish
GitHub stars
2.2k
Token cost
~2.1k tokens
SKILL.md length
758 words
Files
1
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation.

  • The user asks to search
  • SKILL.md covers When This Skill Should Trigger, Picking the Right Tool, Commands and General Notes
  • Calls npm; reaches pizzahut.com and result1.com; needs TINYFISH_API_KEY and TINYFISH_PROXY_PASSWORD
  • Get information from the web

What it does

Use Tinyfish is an agent skill from tinyfish-io/tinyfish-cookbook. Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation. Use whenever the user asks to search, find, look up, research, compare, get information from the web, summarize a URL, fetch page content, or automate a website.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Browser automation, Web scraping and Web search. The repository describes itself as: A collection of sample apps and recipes built with the TinyFish web agent. Open-source examples for you to learn & build! The licence is MIT.

When your agent uses it

  • The user asks to search
  • Get information from the web
  • Summarize a URL
  • Fetch page content

Example prompts

  • “/use-tinyfish”

Requirements

  • Node.js
  • A credential in TINYFISH_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 292ee62. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • pizzahut.com
    • result1.com
    • result2.com
    • nike.com
    • site-a.com
    • site-b.com
    • site-c.com
    • dominos.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TINYFISH_API_KEY
    • TINYFISH_PROXY_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Use Tinyfish loads about 2.1k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 758 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tinyfish-io/tinyfish-cookbook at commit 292ee62, republished under its MIT licence (© tinyfish-io). 758 words, ~2,141 tokens.

Download SKILL.mdSave it as .claude/skills/use-tinyfish/SKILL.md (or your agent's skills folder).
name
use-tinyfish
description
Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation. Use whenever the user asks to search, find, look up, research, compare, get information from the web, summarize a URL, fetch page content, or automate a website.

TinyFish CLI

You have access to the TinyFish CLI (tinyfish) — a suite of web tools you can call from the terminal.

If not installed: npm install -g @tiny-fish/cli If not authenticated: tinyfish auth login --source openclaw or set TINYFISH_API_KEY env var.


When This Skill Should Trigger

Use TinyFish whenever a request depends on live web information or page content. Do not wait for the user to say "TinyFish" or "scrape".

Strong triggers include:

  • Search or discovery: search, find, look up, research, compare, latest, current, news, docs, pricing, product details, best options.
  • URL/page reading: fetch, read, summarize, extract from this page, inspect this URL, get the content, pull links or metadata.
  • Source-backed answers: answer using web sources, verify a fact, check whether something changed, gather information from the web.
  • Website work: interact with a site, click through pages, fill forms, log in, collect structured data, handle bot-protected pages.

Default to the lightest tool that can answer:

  • No URL and the user needs web information: search, then fetch the best result(s) if more detail is needed.
  • URL provided and only content is needed: fetch.
  • Page interaction or dynamic extraction is needed: agent.
  • Raw CDP/Playwright-style control is needed: browser.

Picking the Right Tool

TinyFish has four tools. Start with the lightest one that can do the job and escalate only when needed.

search  →  fetch  →  agent  →  browser
lightest                        heaviest
ToolWhen to useSpeedCost
searchYou need to find URLs, current facts, docs, pricing, product details, or a quick source-backed answerFastestLowest
fetchYou have URLs and need clean page content, summaries, article text, docs, product pages, links, or metadataFastLow
agentYou need to interact with a page — click, fill forms, navigate, extract structured data from dynamic sitesSlowerHigher
browserAgent isn't enough — you need raw programmatic browser control via CDPSlowestHighest
Common Patterns

Research: search → fetch Search for a topic, then fetch the best results to read their full content.

bash
# 1. Find URLs
tinyfish search query "best React state management libraries 2026"

# 2. Read the top results
tinyfish fetch content get --format markdown "https://result1.com" "https://result2.com"

Deep extraction: search → agent Search to find the right site, then use agent to interact with it and extract structured data.

bash
# 1. Find the site
tinyfish search query "Nike running shoes official store"

# 2. Automate extraction on it
tinyfish agent run --url "https://nike.com/running" \
  "Extract all running shoes as JSON: [{\"name\": str, \"price\": str, \"colors\": [str]}]"

Escalation: fetch → agent Try fetch first. If the page is dynamic/JS-heavy and fetch returns empty or incomplete content, escalate to agent.

Full control: agent → browser If agent can't handle a complex multi-step workflow, spin up a raw browser session and automate it yourself via CDP.


Commands

tinyfish search query

Web search. Returns ranked results with titles, URLs, and snippets.

bash
tinyfish search query "<query>" [--location <hint>] [--language <hint>] [--pretty]
  • Returns 10 results by default
  • Use --location and --language for geo-targeted results
  • Default output is JSON; --pretty for human-readable
bash
tinyfish search query "best pho in Ho Chi Minh City" --location "Vietnam" --language "en"

tinyfish fetch content get

Fetch clean, extracted content from one or more URLs. Strips ads, nav, boilerplate — returns just the content.

bash
tinyfish fetch content get <urls...> [--format markdown|html|json] [--links] [--image-links] [--pretty]
  • Accepts multiple URLs in a single call — they are fetched in parallel server-side
  • --format markdown (default) — clean readable text
  • --format json — structured document tree
  • --links — include all extracted links from the page
  • --image-links — include extracted image URLs
  • Response includes: url, final_url, title, language, author, published_date, text, latency_ms
bash
# Fetch one page as markdown
tinyfish fetch content get --format markdown "https://example.com/article"

# Fetch multiple pages with links
tinyfish fetch content get --links "https://site-a.com" "https://site-b.com" "https://site-c.com"

Show full SKILL.md (274 more words)Show less
tinyfish agent run

Run a browser automation using a natural language goal. The agent opens a real browser, navigates, clicks, fills forms, and extracts data.

bash
tinyfish agent run --url <url> "<goal>" [--sync] [--async] [--pretty]
FlagPurpose
--url <url>Target URL (bare hostnames get https:// auto-prepended)
--syncWait for full result without streaming steps
--asyncSubmit and return immediately
--prettyHuman-readable output

Output: Default streams data: {...} SSE lines. The final result is the event where type == "COMPLETE" and status == "COMPLETED" — the extracted data is in the resultJson field. Read the raw output directly; no script-side parsing is needed.

Always specify the JSON structure you want in the goal:

bash
tinyfish agent run --url "https://example.com/products" \
  "Extract all products as JSON array: [{\"name\": str, \"price\": str, \"url\": str}]"

tinyfish agent run --url "https://example.com/search" \
  "Search for 'wireless headphones', filter under $50, extract top 5 as JSON: [{\"name\": str, \"price\": str, \"rating\": str}]"

Parallel extraction — when hitting multiple independent sites, make separate calls. Do NOT combine into one goal.

Good — parallel calls (run simultaneously):

bash
tinyfish agent run --url "https://pizzahut.com" \
  "Extract pizza prices as JSON: [{\"name\": str, \"price\": str}]"

tinyfish agent run --url "https://dominos.com" \
  "Extract pizza prices as JSON: [{\"name\": str, \"price\": str}]"

Bad — single combined call:

bash
# Don't do this — less reliable and slower
tinyfish agent run --url "https://pizzahut.com" \
  "Extract prices from Pizza Hut and also go to Dominos..."

Managing runs:

bash
tinyfish agent run list [--status PENDING|RUNNING|COMPLETED|FAILED|CANCELLED] [--limit N]
tinyfish agent run get <run_id>
tinyfish agent run cancel <run_id>

Batch operations — submit many runs from a CSV file (url,goal columns):

bash
tinyfish agent batch run --input runs.csv
tinyfish agent batch list
tinyfish agent batch get <batch_id>
tinyfish agent batch cancel <batch_id>

tinyfish browser session create

Spin up a remote browser instance. Returns a CDP WebSocket URL for programmatic control.

bash
tinyfish browser session create [--url <url>] [--proxy-country <code> | --proxy-url <url> [--proxy-username <user>] | --no-proxy] [--pretty]
  • --url optionally navigates to a page after creation
  • Returns session_id, cdp_url (WebSocket), and base_url
  • Use the cdp_url with Playwright, Puppeteer, or any CDP client
  • By default traffic exits through the TinyFish proxy in the US, with the same IP for the whole session
  • --proxy-country <code> picks another exit country (ISO 3166-1 alpha-2, e.g. DE, JP)
  • --proxy-url <url> routes through the user's own HTTP(S) proxy; --proxy-username <user> for auth, password via TINYFISH_PROXY_PASSWORD env (never a flag)
  • --no-proxy connects directly, without a proxy
bash
tinyfish browser session create --url "https://example.com"
# Returns: { session_id, cdp_url: "wss://...", base_url: "https://..." }

tinyfish browser session create --url "https://example.de" --proxy-country DE

General Notes

  • Match the user's language: Respond in whatever language the user writes in.
  • All commands support --pretty for human-readable output. Default is JSON.
  • Use --debug on the root command or set TINYFISH_DEBUG=1 to log HTTP requests to stderr.

© tinyfish-io, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/use-tinyfish of tinyfish-io/tinyfish-cookbook.

Open the folder on GitHubat commit 292ee62

Compare with similar skills

Use Tinyfish next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Use Tinyfish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Use Tinyfish this skilltinyfish-io/tinyfish-cookbook2.2k—~2.1kAutomated safety check: PassMIT
Web Research Workflowyonatangross/orchestkit288—~988Automated safety check: NotesMIT
Web Access via Browser CDPeze-is/web-access9.1k4 repos~2.2kAutomated safety check: PassMIT
Reddit JSON Fetcherykdojo/claude-code-tips10k—~1.4kAutomated safety check: PassCustom licence
Ego Browser Searchtaxueseek/argo184—~2.1kAutomated safety check: PassMIT
Bright Data MCPbrightdata/skills2641 repos~3.7kAutomated safety check: PassMIT

Similar skills

  • Web Research Workflow

    yonatangross/orchestkit

    Unified decision tree for web research and competitive monitoring.

    288 GitHub stars~988 tokensUpdated yesterday
    Productivity & AutomationAuto-check: notes
  • Routes every web task, from searching to logged-in browsing, through a tiered choice of search, fetch, curl or a real Chrome or Edge session driven over CDP.

    9.1k GitHub starsUsed in 4 repos~2.2k tokens
    Productivity & AutomationAuto-check passed
  • Reddit JSON Fetcher

    ykdojo/claude-code-tips

    Fetches Reddit posts, threads and search results as JSON through a browser session, using a DuckDuckGo redirect to get past Reddit's automated-access block.

    10k GitHub stars~1.4k tokensUpdated 12 days ago
    Productivity & AutomationAuto-check passed
  • Ego Browser Search

    taxueseek/argo

    Searches and fetches pages through a real logged-in Chromium session when ordinary API or HTML retrieval cannot get past login walls, scripts or anti-bot checks.

    184 GitHub stars~2.1k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Bright Data MCP

    brightdata/skills

    Bright Data MCP handles ALL web data operations. An agent skill from brightdata/skills.

    264 GitHub starsUsed in 1 repo~3.7k tokens
    Productivity & AutomationAuto-check passed
  • Scrapingbee CLI

    ScrapingBee/scrapingbee-cli

    Fetch and read any web page, search the web, crawl a site, or pull structured data out of pages.

    108 GitHub stars~3.1k tokensUpdated 26 days ago
    Productivity & AutomationAuto-check passed

More from tinyfish-io/tinyfish-cookbook

All 28 skills in this repo
  • Tinyfish Social Listening

    tinyfish-io/tinyfish-cookbook

    Monitor brand mentions, sentiment, and industry chatter across the web using TinyFish Search and Fetch.

    2.2k GitHub stars~5.4k tokensUpdated 6 days ago
    Auto-check passed
  • Academic Research Mapper

    tinyfish-io/tinyfish-cookbook

    Map the research landscape for any technical or academic topic by searching arXiv, Semantic Scholar, and Google Scholar in parallel.

    2.2k GitHub stars~3.5k tokensUpdated 6 days ago
    Auto-check passed
  • Agent

    tinyfish-io/tinyfish-cookbook

    Default browser automation agent — click, fill forms, navigate, log in, and extract structured data from any website using a natural-language goal, or run the same task across multiple sites in…

    2.2k GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed
  • Company Hiring Intelligence

    tinyfish-io/tinyfish-cookbook

    Reverse-engineer what a company is building by scraping their job postings, careers page, LinkedIn Jobs, and engineering blog using TinyFish web agents.

    2.2k GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check passed
  • Competitor Product Monitor

    tinyfish-io/tinyfish-cookbook

    Monitor competitor product releases and new feature announcements.

    2.2k GitHub stars~1.7k tokensUpdated 6 days ago
    Auto-check passed
  • Dep Security

    tinyfish-io/tinyfish-cookbook

    Check every dependency in a package.json against live CVE databases and security advisories in real time — specifically targeting vulnerabilities disclosed in the last 48 hours, the window that…

    2.2k GitHub stars~2.4k tokensUpdated 6 days ago
    Auto-check passed

Questions about Use Tinyfish

What does Use Tinyfish do?

Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation. Use Tinyfish is an agent skill from tinyfish-io/tinyfish-cookbook. Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation.

When should I use Use Tinyfish?

Use Tinyfish fits situations like: the user asks to search; get information from the web; summarize a URL; fetch page content.

How do I install Use Tinyfish in Claude Code?

Run `npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a claude-code`. Or copy the skill folder (skills/use-tinyfish in tinyfish-io/tinyfish-cookbook) into .claude/skills/use-tinyfish in your project. Claude Code loads it when a task matches its description.

How do I install Use Tinyfish in Codex?

Run `npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a codex`. Or copy the skill folder (skills/use-tinyfish in tinyfish-io/tinyfish-cookbook) into .agents/skills/use-tinyfish in your project. Codex loads it when a task matches its description.

Can I use Use Tinyfish in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/use-tinyfish, .gemini/skills/use-tinyfish, .github/skills/use-tinyfish and .opencode/skills/use-tinyfish in your project.

What does Use Tinyfish need to run?

Going by SKILL.md and its folder, Use Tinyfish needs the command-line tools its instructions call (npm) and credentials named TINYFISH_API_KEY and TINYFISH_PROXY_PASSWORD. Our summary lists: Node.js; A credential in TINYFISH_API_KEY.

Does Use Tinyfish access the network?

SKILL.md names 8 domains. In commands or code: pizzahut.com, result1.com, result2.com, nike.com, site-a.com, site-b.com, site-c.com and dominos.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Use Tinyfish safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Use Tinyfish use?

Use Tinyfish is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Use Tinyfish use?

About 2.1k tokens (SKILL.md is roughly 8.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Use Tinyfish?

Skills that share tags, products or a category with Use Tinyfish: Web Research Workflow (yonatangross/orchestkit, 288 stars), Web Access via Browser CDP (eze-is/web-access, 9.1k stars), Reddit JSON Fetcher (ykdojo/claude-code-tips, 10k stars) and Ego Browser Search (taxueseek/argo, 184 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Use Tinyfish?

tinyfish-io (a GitHub organization) maintains it in tinyfish-io/tinyfish-cookbook, which has 2,221 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on October 1, 2026.

Source: tinyfish-io/tinyfish-cookbook on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.