Web Research Workflow
yonatangross/orchestkit
Unified decision tree for web research and competitive monitoring.
Use TinyFish for web search, fetching URLs, reading pages, current information, source-backed answers, research, docs, pricing/product pages, extraction, scraping, and browser automation.
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfish --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-srcUse ~/.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/
Install the "use-tinyfish" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfish into .claude/skills/use-tinyfish/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-tinyfish", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfishType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfish --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/use-tinyfish .agents/skills/use-tinyfish && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "use-tinyfish" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfish into .agents/skills/use-tinyfish/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-tinyfish", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfish --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/use-tinyfish .cursor/skills/use-tinyfish && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "use-tinyfish" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfish into .cursor/skills/use-tinyfish/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-tinyfish", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/tinyfish-io/tinyfish-cookbook.git --path skills/use-tinyfish--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfish --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/use-tinyfish .gemini/skills/use-tinyfish && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "use-tinyfish" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfish into .gemini/skills/use-tinyfish/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-tinyfish", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfishInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/use-tinyfish .github/skills/use-tinyfish && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "use-tinyfish" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfish into .github/skills/use-tinyfish/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-tinyfish", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add tinyfish-io/tinyfish-cookbook --skill use-tinyfish -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install tinyfish-io/tinyfish-cookbook use-tinyfish --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/tinyfish-io/tinyfish-cookbook.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/use-tinyfish .opencode/skills/use-tinyfish && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "use-tinyfish" agent skill from https://github.com/tinyfish-io/tinyfish-cookbook/tree/main/skills/use-tinyfish into .opencode/skills/use-tinyfish/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "use-tinyfish", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
use-tinyfishUse 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. 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.
Read from SKILL.md and the folder at commit 292ee62. It shows what the files ask for, not the result of running them.
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.
Shell commands in SKILL.md call:
npmFrom the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
pizzahut.comresult1.comresult2.comnike.comsite-a.comsite-b.comsite-c.comdominos.comFrom URLs in SKILL.md, links to its own repository left out.
Names these keys or tokens, usually read from environment variables:
TINYFISH_API_KEYTINYFISH_PROXY_PASSWORDFrom names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
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.
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.
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.
The full file from tinyfish-io/tinyfish-cookbook at commit 292ee62, republished under its MIT licence (© tinyfish-io). 758 words, ~2,141 tokens.
.claude/skills/use-tinyfish/SKILL.md (or your agent's skills folder).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.
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:
Default to the lightest tool that can answer:
search, then fetch the best result(s) if more detail is needed.fetch.agent.browser.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| Tool | When to use | Speed | Cost |
|---|---|---|---|
| search | You need to find URLs, current facts, docs, pricing, product details, or a quick source-backed answer | Fastest | Lowest |
| fetch | You have URLs and need clean page content, summaries, article text, docs, product pages, links, or metadata | Fast | Low |
| agent | You need to interact with a page — click, fill forms, navigate, extract structured data from dynamic sites | Slower | Higher |
| browser | Agent isn't enough — you need raw programmatic browser control via CDP | Slowest | Highest |
Research: search → fetch Search for a topic, then fetch the best results to read their full content.
# 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.
# 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.
tinyfish search queryWeb search. Returns ranked results with titles, URLs, and snippets.
tinyfish search query "<query>" [--location <hint>] [--language <hint>] [--pretty]--location and --language for geo-targeted results--pretty for human-readabletinyfish search query "best pho in Ho Chi Minh City" --location "Vietnam" --language "en"tinyfish fetch content getFetch clean, extracted content from one or more URLs. Strips ads, nav, boilerplate — returns just the content.
tinyfish fetch content get <urls...> [--format markdown|html|json] [--links] [--image-links] [--pretty]--format markdown (default) — clean readable text--format json — structured document tree--links — include all extracted links from the page--image-links — include extracted image URLsurl, final_url, title, language, author, published_date, text, latency_ms# 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"tinyfish agent runRun a browser automation using a natural language goal. The agent opens a real browser, navigates, clicks, fills forms, and extracts data.
tinyfish agent run --url <url> "<goal>" [--sync] [--async] [--pretty]| Flag | Purpose |
|---|---|
--url <url> | Target URL (bare hostnames get https:// auto-prepended) |
--sync | Wait for full result without streaming steps |
--async | Submit and return immediately |
--pretty | Human-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:
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):
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:
# 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:
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):
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 createSpin up a remote browser instance. Returns a CDP WebSocket URL for programmatic control.
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 creationsession_id, cdp_url (WebSocket), and base_urlcdp_url with Playwright, Puppeteer, or any CDP client--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 proxytinyfish 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--pretty for human-readable output. Default is JSON.--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
Just SKILL.md in skills/use-tinyfish of tinyfish-io/tinyfish-cookbook.
Open the folder on GitHubat commit 292ee62
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Use Tinyfish this skilltinyfish-io/tinyfish-cookbook | 2.2k | — | ~2.1k | Automated safety check: Pass | MIT | |
| Web Research Workflowyonatangross/orchestkit | 288 | — | ~988 | Automated safety check: Notes | MIT | |
| Web Access via Browser CDPeze-is/web-access | 9.1k | 4 repos | ~2.2k | Automated safety check: Pass | MIT | |
| Reddit JSON Fetcherykdojo/claude-code-tips | 10k | — | ~1.4k | Automated safety check: Pass | Custom licence | |
| Ego Browser Searchtaxueseek/argo | 184 | — | ~2.1k | Automated safety check: Pass | MIT | |
| Bright Data MCPbrightdata/skills | 264 | 1 repos | ~3.7k | Automated safety check: Pass | MIT |
yonatangross/orchestkit
Unified decision tree for web research and competitive monitoring.
eze-is/web-access
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.
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.
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.
brightdata/skills
Bright Data MCP handles ALL web data operations. An agent skill from brightdata/skills.
ScrapingBee/scrapingbee-cli
Fetch and read any web page, search the web, crawl a site, or pull structured data out of pages.
tinyfish-io/tinyfish-cookbook
Monitor brand mentions, sentiment, and industry chatter across the web using TinyFish Search and Fetch.
tinyfish-io/tinyfish-cookbook
Map the research landscape for any technical or academic topic by searching arXiv, Semantic Scholar, and Google Scholar in parallel.
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…
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.
tinyfish-io/tinyfish-cookbook
Monitor competitor product releases and new feature announcements.
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…
Categories
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.
Use Tinyfish fits situations like: the user asks to search; get information from the web; summarize a URL; fetch page content.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.