{"id":"fbbc8262-362b-4afd-9f6f-ba9010baf976","entityType":"agent","slug":"rioiart-tavily-skill","name":"tavily-search-and-fetch","canonicalUrl":"https://www.xpersona.co/agent/rioiart-tavily-skill","canonicalPath":"/agent/rioiart-tavily-skill","generatedAt":"2026-10-09T13:57:55.287Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for factual search, current events, financial data, full content extraction, site map URLs, or comprehensive research reports. Topics: general, news, finance. --- name: tavily-search-and-fetch description: \"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for factual search, current events, financial data, full content extraction, site map URLs, or comprehensive research reports. Topics: general, news, finance.\" metadata: { \"openclaw\": { \"emoji\": \"🔍\", \"requires\": { \"b","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. Last updated 4/15/2026.","installCommand":"git clone https://github.com/rioiart/tavily-skill.git","sourceUrl":"https://github.com/rioiart/tavily-skill","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/rioiart/tavily-skill","kind":"source"}],"safetyScore":94,"overallRank":29.7,"popularityScore":0,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for f"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"no-adoption-signals","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No source adoption metrics were available."},"stars":0,"forks":0,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":null},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-04-15T02:13:22.773Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-04-15T02:13:22.773Z","lastIndexedAt":null,"nextCrawlAt":"2026-04-16T02:13:22.773Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"git clone https://github.com/rioiart/tavily-skill.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T13:57:55.287Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/rioiart-tavily-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"---\nname: tavily-search-and-fetch\ndescription: \"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for factual search, current events, financial data, full content extraction, site map URLs, or comprehensive research reports. Topics: general, news, finance.\"\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"🔍\",\n        \"requires\": { \"bins\": [\"curl\", \"jq\"], \"env\": [\"TAVILY_API_KEY\"] },\n        \"primaryEnv\": \"TAVILY_API_KEY\",\n        \"install\":\n          [\n            {\n              \"id\": \"jq-brew\",\n              \"kind\": \"brew\",\n              \"formula\": \"jq\",\n              \"bins\": [\"jq\"],\n              \"label\": \"Install jq (brew)\",\n            },\n          ],\n      },\n  }\n---\n\n# Tavily Researcher\n\nWeb research via Tavily's LLM-optimized APIs: search, extract, sitemap, and research.\n\n## Setup\n\nRequires `TAVILY_API_KEY` environment variable. Get a free key (1000 credits/month) at https://app.tavily.com\n\n## Choosing the Right Tool\n\n| Need | Script |\n|------|--------|\n| Web search results | `tavily_search.sh` |\n| Content from specific URLs | `tavily_extract.sh` |\n| Discover URLs on a site (fast) | `tavily_sitemap.sh` |\n| AI-synthesized report with citations | `tavily_research.sh` |\n\n## Quick Start\n\n### Search\n```bash\nscripts/tavily_search.sh \"What is retrieval augmented generation?\" --include-answer\n```\n\n### News Search\n```bash\nscripts/tavily_search.sh \"AI regulation updates\" --topic news --time-range week\n```\n\n### Extract Content from URLs\n```bash\nscripts/tavily_extract.sh https://example.com/article1 https://example.com/article2\n```\n\n### Discover URLs on a Site\n```bash\nscripts/tavily_sitemap.sh https://docs.example.com --max-depth 2 --limit 100\n```\n\n### AI Research Report\n```bash\nscripts/tavily_research.sh \"Compare LangGraph vs CrewAI for multi-agent systems\" --model pro\n```\n\n## Scripts\n\n### `tavily_search.sh`\nStandard web search. Returns titles, URLs, snippets, and optional AI answer.\n\n**Key options:**\n- `--depth ultra-fast|fast|basic|advanced` — Trade speed for relevance\n- `--topic general|news|finance` — Optimize for content type\n- `--include-answer` — Get AI-generated summary\n- `--include-raw-content` — Get full page content\n- `--time-range day|week|month|year` — Filter by recency\n- `--chunks-per-source N` — Chunks per source (1-5, advanced/fast)\n- `--include-domains` / `--exclude-domains` — Filter sources\n\n### `tavily_extract.sh`\nExtract full content from specific URLs (up to 20 at once).\n\n**Key options:**\n- `--depth basic|advanced` — Use advanced for JS-heavy pages\n- `--query TEXT` — Rerank chunks by relevance\n- `--chunks-per-source N` — Return only relevant chunks (1-5, requires --query)\n- `--format markdown|text` — Output format\n\n### `tavily_sitemap.sh`\nDiscover URLs on a website without extracting content. Faster than crawl — use to understand site structure first.\n\n**Key options:**\n- `--max-depth N` — Crawl depth 1-5 (start with 1)\n- `--limit N` — Total URLs cap (default: 50)\n- `--instructions TEXT` — Focus on specific types of pages\n\n### `tavily_research.sh`\nAI-synthesized research with citations. Takes 30-120 seconds.\n\n**Key options:**\n- `--model mini|pro|auto` — mini for focused queries, pro for comprehensive analysis\n- `--citation-format numbered|mla|apa|chicago`\n- `--output-schema JSON` — Get structured JSON output\n- `--output-file PATH` — Save results to file\n\n## Cost Optimization\n\n| Task | Recommended Approach | Credits |\n|------|---------------------|---------|\n| Quick fact check | `tavily_search.sh --include-answer` | 1 |\n| Deeper search | `tavily_search.sh --depth advanced` | 2 |\n| Full article content | `tavily_extract.sh <urls>` | 1 per 5 URLs |\n| Discover site URLs | `tavily_sitemap.sh` | 1 |\n| AI research report | `tavily_research.sh` | varies |\n\n## Domain-Specific Search\n```bash\n# Only search specific sites\nscripts/tavily_search.sh \"async python\" --include-domains docs.python.org,realpython.com\n\n# Exclude unreliable sources\nscripts/tavily_search.sh \"health advice\" --exclude-domains reddit.com,quora.com\n```\n\n## API Reference\n\nSee `references/api_reference.md` for full parameter documentation.\n","readmeExcerpt":"--- name: tavily-search-and-fetch description: \"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for factual search, current events, financial data, full content extraction, site map URLs, or comprehensive research reports. Topics: general, news, finance.\" metadata: { \"openclaw\": { \"emoji\": \"🔍\", \"requires\": { \"b","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"scripts/tavily_search.sh \"What is retrieval augmented generation?\" --include-answer"},{"language":"bash","snippet":"scripts/tavily_search.sh \"AI regulation updates\" --topic news --time-range week"},{"language":"bash","snippet":"scripts/tavily_extract.sh https://example.com/article1 https://example.com/article2"},{"language":"bash","snippet":"scripts/tavily_sitemap.sh https://docs.example.com --max-depth 2 --limit 100"},{"language":"bash","snippet":"scripts/tavily_research.sh \"Compare LangGraph vs CrewAI for multi-agent systems\" --model pro"},{"language":"bash","snippet":"# Only search specific sites\nscripts/tavily_search.sh \"async python\" --include-domains docs.python.org,realpython.com\n\n# Exclude unreliable sources\nscripts/tavily_search.sh \"health advice\" --exclude-domains reddit.com,quora.com"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for factual search, current events, financial data, full content extraction, site map URLs, or comprehensive research reports. Topics: general, news, finance. --- name: tavily-search-and-fetch description: \"Web (re)earch using Tavily APIs. Search the web, extract content from URLs, discover site maps, or get AI-synthesized research reports with citations. Use for factual search, current events, financial data, full content extraction, site map URLs, or comprehensive research reports. Topics: general, news, finance.\" metadata: { \"openclaw\": { \"emoji\": \"🔍\", \"requires\": { \"b","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":428,"uniquenessScore":59,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:57:55.287Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}