How do I install the Tavily skill?

Run npx skillmds@latest add kcnyu/tavily in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Tavily skill do?

AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents. It is listed under Integrations & APIs on SkillMD.

Is Tavily safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tavily?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tavily free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tavily?

KCNyu (@kcnyu) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tavily by kcnyu — Agent Skill

Name: Tavily
Author: KCNyu

File contents

Tavily Search

AI-optimized web search using Tavily API. Designed for AI agents - returns clean, relevant content.

Search

node {baseDir}/scripts/search.mjs "query" --bucket research
node {baseDir}/scripts/search.mjs "query" -n 10 --bucket research
node {baseDir}/scripts/search.mjs "query" --deep --bucket research
node {baseDir}/scripts/search.mjs "query" --topic news --bucket research

Options

-n <count>: Number of results (default: 5, max: 20)
--deep: Use advanced search for deeper research (slower, more comprehensive)
--topic <topic>: Search topic - general (default) or news
--days <n>: For news topic, limit to last n days
--bucket <name>: Which monthly budget bucket to charge — brief / report / intraday / research / extract / default. Ad-hoc/manual research uses --bucket research. Omitting it charges the small default bucket (60/mo), which is exhausted quickly on purpose.

Budget (免费档 1000 credits/月, 全局共享)

basic 搜索 1 credit，--deep 2，extract 1/5 URL。硬护栏在 lib/ledger.mjs（本地月度账本，reservation 式扣费，超限 exit 0 优雅降级返回 "unavailable" — 别当报错，退回内置搜索）。账本在仓库外 /root/.openclaw/tavily-credit-ledger.json；查真实账单：curl -H "Authorization: Bearer $TAVILY_API_KEY" https://api.tavily.com/usage（注意有延迟，不能当实时闸）。

Extract content from URL

node {baseDir}/scripts/extract.mjs "https://example.com/article" --bucket extract

--bucket works the same as for search (charges that monthly bucket; omit → default). extract costs 1 credit per 5 URLs.

Notes:

Needs TAVILY_API_KEY from https://tavily.com
Tavily is optimized for AI - returns clean, relevant snippets
Use --deep for complex research questions
Use --topic news for current events

---name: tavilydescription: AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.---# Tavily SearchAI-optimized web search using Tavily API. Designed for AI agents - returns clean, relevant content.## Search```bashnode {baseDir}/scripts/search.mjs "query" --bucket researchnode {baseDir}/scripts/search.mjs "query" -n 10 --bucket researchnode {baseDir}/scripts/search.mjs "query" --deep --bucket researchnode {baseDir}/scripts/search.mjs "query" --topic news --bucket research```## Options- `-n <count>`: Number of results (default: 5, max: 20)- `--deep`: Use advanced search for deeper research (slower, more comprehensive)- `--topic <topic>`: Search topic - `general` (default) or `news`- `--days <n>`: For news topic, limit to last n days- `--bucket <name>`: **Which monthly budget bucket to charge** — `brief` / `report` / `intraday` / `research` / `extract` / `default`. Ad-hoc/manual research uses `--bucket research`. **Omitting it charges the small `default` bucket (60/mo)**, which is exhausted quickly on purpose.## Budget (免费档 1000 credits/月, 全局共享)basic 搜索 1 credit，`--deep` 2，extract 1/5 URL。硬护栏在 `lib/ledger.mjs`（本地月度账本，reservation 式扣费，超限 **exit 0** 优雅降级返回 "unavailable" — **别当报错**，退回内置搜索）。账本在仓库外 `/root/.openclaw/tavily-credit-ledger.json`；查真实账单：`curl -H "Authorization: Bearer $TAVILY_API_KEY" https://api.tavily.com/usage`（注意有延迟，不能当实时闸）。## Extract content from URL```bashnode {baseDir}/scripts/extract.mjs "https://example.com/article" --bucket extract````--bucket` works the same as for search (charges that monthly bucket; omit → `default`). extract costs 1 credit per 5 URLs.Notes:- Needs `TAVILY_API_KEY` from https://tavily.com- Tavily is optimized for AI - returns clean, relevant snippets- Use `--deep` for complex research questions- Use `--topic news` for current events

Frequently asked questions

Tavily