tavilylisted

# Tavily Search AI-optimized web search using Tavily API. Designed for AI agents - returns clean, relevant content. ## Search ```bash 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 ```bash node {baseDir}/scripts/extract.mjs "https://example.com/article" --bucket extract ``` `--bucket` works the same as for search (charges that monthly bucket; omit → `defa