{ "schemaVersion": "1.0", "item": { "slug": "bocha-skill", "name": "bocha-skill", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ypw757/bocha-skill", "canonicalUrl": "https://clawhub.ai/ypw757/bocha-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/bocha-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bocha-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "scripts/bocha_search.js", "scripts/package.json", "scripts/tool.json", "README.md", "PUBLISH.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/bocha-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/bocha-skill", "agentPageUrl": "https://openagent3.xyz/skills/bocha-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/bocha-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/bocha-skill/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Bocha Search Skill for OpenClaw", "body": "🔍 博查AI搜索 - 专为中文内容优化的智能搜索工具" }, { "title": "Overview", "body": "This skill provides web search capabilities through the Bocha AI Search API (博查AI搜索). It's particularly effective for:\n\n✅ Chinese language searches (中文搜索)\n✅ Domestic Chinese content (国内内容)\n✅ News and current events (新闻资讯)\n✅ Encyclopedia and knowledge queries (百科知识)\n✅ High-quality AI-generated summaries (AI智能摘要)" }, { "title": "Requirements", "body": "API Key: You need a Bocha API key from https://open.bocha.cn/\nNode.js: Required to run the search script\nEnvironment Variable: Set BOCHA_API_KEY or configure via OpenClaw settings" }, { "title": "Step 1: Get API Key", "body": "Visit 博查AI开放平台\nRegister an account (注册账号)\nCreate an application and get your API KEY\nRecharge if needed (充值以获得搜索额度)" }, { "title": "Step 2: Configure OpenClaw", "body": "Add to ~/.openclaw/openclaw.json:\n\n{\n \"skills\": {\n \"entries\": {\n \"bocha-search\": {\n \"enabled\": true,\n \"apiKey\": \"your-bocha-api-key-here\",\n \"env\": {\n \"BOCHA_API_KEY\": \"your-bocha-api-key-here\"\n }\n }\n }\n }\n}\n\nOr set environment variable:\n\nexport BOCHA_API_KEY=\"your-bocha-api-key-here\"" }, { "title": "Usage", "body": "Once configured, you can use this skill by asking in Chinese or English:\n\n\"搜索北京今天的天气\"\n\"用博查查找人工智能的最新进展\"\n\"bocha search: 量子计算发展趋势\"\n\"查找特朗普的最新新闻\"\n\nThe skill will automatically route Chinese queries or explicit \"bocha\" / \"博查\" / \"search\" requests to this search provider." }, { "title": "Features", "body": "FeatureDescriptionChinese OptimizedBetter results for Chinese language queriesHigh-Quality SummariesAI-generated article summaries (when summary: true)Multi-ModalReturns web pages, images, and related contentTime FilteringFilter results by time range (day/week/month/year)Fast ResponseTypically returns results within 1-2 secondsRich MetadataIncludes publish date, site name, favicon, etc." }, { "title": "API Parameters", "body": "When calling the underlying tool directly:\n\nParameterTypeRequiredDefaultDescriptionquerystring✅ Yes-Search query (supports Chinese and English)countnumberNo10Number of results (1-50)freshnessstringNo\"noLimit\"Time filter: \"oneDay\", \"oneWeek\", \"oneMonth\", \"oneYear\", \"noLimit\"summarybooleanNotrueWhether to include AI-generated summaries" }, { "title": "Example Tool Call", "body": "// Search for recent AI news in Chinese\n{\n \"query\": \"人工智能最新进展\",\n \"count\": 10,\n \"freshness\": \"oneWeek\",\n \"summary\": true\n}\n\n// Search for Trump news\n{\n \"query\": \"特朗普 Trump 最新新闻\",\n \"count\": 5,\n \"freshness\": \"oneDay\"\n}" }, { "title": "Response Format", "body": "The API returns structured data including:\n\nWeb Pages: Title, URL, snippet, summary, site name, publish date\nImages: Thumbnail URL, full image URL, dimensions\nTotal Matches: Estimated total number of matching results\nRelated Queries: Suggested related search terms" }, { "title": "Sample Response Structure", "body": "{\n \"_type\": \"SearchResponse\",\n \"queryContext\": {\n \"originalQuery\": \"search term\"\n },\n \"webPages\": {\n \"totalEstimatedMatches\": 1908646,\n \"value\": [\n {\n \"name\": \"Article Title\",\n \"url\": \"https://example.com/article\",\n \"snippet\": \"Short description...\",\n \"summary\": \"Full AI-generated summary...\",\n \"siteName\": \"Example Site\",\n \"datePublished\": \"2026-01-30T07:19:14+08:00\"\n }\n ]\n },\n \"images\": {\n \"value\": [...]\n }\n}" }, { "title": "Error Handling", "body": "Common errors and solutions:\n\nErrorCauseSolutionBOCHA_API_KEY is requiredAPI key not configuredAdd API key to config or environmentInvalid API KEYWrong API keyCheck your API key at https://open.bocha.cn/Insufficient balanceOut of creditsRecharge your accountRate limit exceededToo many requestsWait before making more requests" }, { "title": "Pricing", "body": "Visit https://open.bocha.cn/pricing for current pricing\nNew users typically get free credits to start\nPay-as-you-go based on search volume" }, { "title": "API Endpoint", "body": "URL: https://api.bocha.cn/v1/web-search\nMethod: POST\nAuth: Bearer token in Authorization header" }, { "title": "Script Location", "body": "skills/bocha-search/\n├── SKILL.md # This file\n├── README.md # Full documentation\n├── LICENSE # MIT License\n└── scripts/\n ├── package.json # Node.js config\n ├── tool.json # OpenClaw tool definition\n └── bocha_search.js # Main search script ⬅️ Entry point" }, { "title": "Comparison with Other Search Tools", "body": "FeatureBocha SearchBrave SearchPerplexityChinese Content⭐⭐⭐ Excellent⭐⭐ Good⭐⭐ GoodSpeed⭐⭐⭐ Fast⭐⭐⭐ Fast⭐⭐ ModerateSummaries⭐⭐⭐ AI-powered❌ No⭐⭐⭐ AI-poweredImages⭐⭐⭐ Included⭐⭐ Separate⭐ LimitedPricing💰 Affordable🆓 Free tier💰 Moderate" }, { "title": "Best Practices", "body": "Use Chinese queries for better Chinese content results\nEnable summaries (summary: true) for better context\nSet appropriate freshness based on your needs:\n\nBreaking news: \"oneDay\"\nRecent developments: \"oneWeek\"\nGeneral research: \"noLimit\"\n\n\nStart with count=10, increase if needed (max 50)\nHandle rate limits gracefully in production use" }, { "title": "No results returned", "body": "Try different keywords or synonyms\nRemove time restrictions (freshness: \"noLimit\")\nCheck if your query is too specific" }, { "title": "Slow response", "body": "Reduce count parameter\nDisable summaries if not needed (summary: false)\nCheck network connectivity to api.bocha.cn" }, { "title": "API errors", "body": "Verify API key is correct and active\nCheck account balance at https://open.bocha.cn/\nEnsure you're not exceeding rate limits" }, { "title": "Links", "body": "🔗 博查AI开放平台\n🔗 API Documentation\n🔗 OpenClaw Docs\n🔗 ClawdHub" }, { "title": "License", "body": "MIT License - See LICENSE file for details\n\nNote: This skill is specifically designed for OpenClaw and uses the official Bocha AI Search API. It is not affiliated with or endorsed by Bocha AI." } ], "body": "Bocha Search Skill for OpenClaw\n\n🔍 博查AI搜索 - 专为中文内容优化的智能搜索工具\n\nOverview\n\nThis skill provides web search capabilities through the Bocha AI Search API (博查AI搜索). It's particularly effective for:\n\n✅ Chinese language searches (中文搜索)\n✅ Domestic Chinese content (国内内容)\n✅ News and current events (新闻资讯)\n✅ Encyclopedia and knowledge queries (百科知识)\n✅ High-quality AI-generated summaries (AI智能摘要)\nRequirements\nAPI Key: You need a Bocha API key from https://open.bocha.cn/\nNode.js: Required to run the search script\nEnvironment Variable: Set BOCHA_API_KEY or configure via OpenClaw settings\nConfiguration\nStep 1: Get API Key\nVisit 博查AI开放平台\nRegister an account (注册账号)\nCreate an application and get your API KEY\nRecharge if needed (充值以获得搜索额度)\nStep 2: Configure OpenClaw\n\nAdd to ~/.openclaw/openclaw.json:\n\n{\n \"skills\": {\n \"entries\": {\n \"bocha-search\": {\n \"enabled\": true,\n \"apiKey\": \"your-bocha-api-key-here\",\n \"env\": {\n \"BOCHA_API_KEY\": \"your-bocha-api-key-here\"\n }\n }\n }\n }\n}\n\n\nOr set environment variable:\n\nexport BOCHA_API_KEY=\"your-bocha-api-key-here\"\n\nUsage\n\nOnce configured, you can use this skill by asking in Chinese or English:\n\n\"搜索北京今天的天气\"\n\"用博查查找人工智能的最新进展\"\n\"bocha search: 量子计算发展趋势\"\n\"查找特朗普的最新新闻\"\n\n\nThe skill will automatically route Chinese queries or explicit \"bocha\" / \"博查\" / \"search\" requests to this search provider.\n\nFeatures\nFeature\tDescription\nChinese Optimized\tBetter results for Chinese language queries\nHigh-Quality Summaries\tAI-generated article summaries (when summary: true)\nMulti-Modal\tReturns web pages, images, and related content\nTime Filtering\tFilter results by time range (day/week/month/year)\nFast Response\tTypically returns results within 1-2 seconds\nRich Metadata\tIncludes publish date, site name, favicon, etc.\nAPI Parameters\n\nWhen calling the underlying tool directly:\n\nParameter\tType\tRequired\tDefault\tDescription\nquery\tstring\t✅ Yes\t-\tSearch query (supports Chinese and English)\ncount\tnumber\tNo\t10\tNumber of results (1-50)\nfreshness\tstring\tNo\t\"noLimit\"\tTime filter: \"oneDay\", \"oneWeek\", \"oneMonth\", \"oneYear\", \"noLimit\"\nsummary\tboolean\tNo\ttrue\tWhether to include AI-generated summaries\nExample Tool Call\n// Search for recent AI news in Chinese\n{\n \"query\": \"人工智能最新进展\",\n \"count\": 10,\n \"freshness\": \"oneWeek\",\n \"summary\": true\n}\n\n// Search for Trump news\n{\n \"query\": \"特朗普 Trump 最新新闻\",\n \"count\": 5,\n \"freshness\": \"oneDay\"\n}\n\nResponse Format\n\nThe API returns structured data including:\n\nWeb Pages: Title, URL, snippet, summary, site name, publish date\nImages: Thumbnail URL, full image URL, dimensions\nTotal Matches: Estimated total number of matching results\nRelated Queries: Suggested related search terms\nSample Response Structure\n{\n \"_type\": \"SearchResponse\",\n \"queryContext\": {\n \"originalQuery\": \"search term\"\n },\n \"webPages\": {\n \"totalEstimatedMatches\": 1908646,\n \"value\": [\n {\n \"name\": \"Article Title\",\n \"url\": \"https://example.com/article\",\n \"snippet\": \"Short description...\",\n \"summary\": \"Full AI-generated summary...\",\n \"siteName\": \"Example Site\",\n \"datePublished\": \"2026-01-30T07:19:14+08:00\"\n }\n ]\n },\n \"images\": {\n \"value\": [...]\n }\n}\n\nError Handling\n\nCommon errors and solutions:\n\nError\tCause\tSolution\nBOCHA_API_KEY is required\tAPI key not configured\tAdd API key to config or environment\nInvalid API KEY\tWrong API key\tCheck your API key at https://open.bocha.cn/\nInsufficient balance\tOut of credits\tRecharge your account\nRate limit exceeded\tToo many requests\tWait before making more requests\nPricing\nVisit https://open.bocha.cn/pricing for current pricing\nNew users typically get free credits to start\nPay-as-you-go based on search volume\nTechnical Details\nAPI Endpoint\nURL: https://api.bocha.cn/v1/web-search\nMethod: POST\nAuth: Bearer token in Authorization header\nScript Location\nskills/bocha-search/\n├── SKILL.md # This file\n├── README.md # Full documentation\n├── LICENSE # MIT License\n└── scripts/\n ├── package.json # Node.js config\n ├── tool.json # OpenClaw tool definition\n └── bocha_search.js # Main search script ⬅️ Entry point\n\nComparison with Other Search Tools\nFeature\tBocha Search\tBrave Search\tPerplexity\nChinese Content\t⭐⭐⭐ Excellent\t⭐⭐ Good\t⭐⭐ Good\nSpeed\t⭐⭐⭐ Fast\t⭐⭐⭐ Fast\t⭐⭐ Moderate\nSummaries\t⭐⭐⭐ AI-powered\t❌ No\t⭐⭐⭐ AI-powered\nImages\t⭐⭐⭐ Included\t⭐⭐ Separate\t⭐ Limited\nPricing\t💰 Affordable\t🆓 Free tier\t💰 Moderate\nBest Practices\nUse Chinese queries for better Chinese content results\nEnable summaries (summary: true) for better context\nSet appropriate freshness based on your needs:\nBreaking news: \"oneDay\"\nRecent developments: \"oneWeek\"\nGeneral research: \"noLimit\"\nStart with count=10, increase if needed (max 50)\nHandle rate limits gracefully in production use\nTroubleshooting\nNo results returned\nTry different keywords or synonyms\nRemove time restrictions (freshness: \"noLimit\")\nCheck if your query is too specific\nSlow response\nReduce count parameter\nDisable summaries if not needed (summary: false)\nCheck network connectivity to api.bocha.cn\nAPI errors\nVerify API key is correct and active\nCheck account balance at https://open.bocha.cn/\nEnsure you're not exceeding rate limits\nLinks\n🔗 博查AI开放平台\n🔗 API Documentation\n🔗 OpenClaw Docs\n🔗 ClawdHub\nLicense\n\nMIT License - See LICENSE file for details\n\nNote: This skill is specifically designed for OpenClaw and uses the official Bocha AI Search API. It is not affiliated with or endorsed by Bocha AI." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ypw757/bocha-skill", "publisherUrl": "https://clawhub.ai/ypw757/bocha-skill", "owner": "ypw757", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/bocha-skill", "downloadUrl": "https://openagent3.xyz/downloads/bocha-skill", "agentUrl": "https://openagent3.xyz/skills/bocha-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/bocha-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/bocha-skill/agent.md" } }