{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bocha-search",
    "name": "博查搜索",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/sunjingji/bocha-search",
    "canonicalUrl": "https://clawhub.ai/sunjingji/bocha-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/bocha-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bocha-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/search.js"
    ],
    "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. 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. 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-search"
    },
    "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-search",
    "agentPageUrl": "https://openagent3.xyz/skills/bocha-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bocha-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bocha-search/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "博查搜索 (Bocha Search)",
        "body": "基于博查 AI 搜索 API 的网页搜索插件，返回结构化的搜索结果，适合大模型使用。"
      },
      {
        "title": "功能特点",
        "body": "🔍 全网搜索，结果准确\n📝 可选返回网页摘要 (summary)\n⏰ 支持时间范围过滤\n🌐 Response 格式兼容 Bing Search API"
      },
      {
        "title": "方式一：配置文件 (推荐)",
        "body": "编辑 config.json：\n\n{\n  \"apiKey\": \"sk-your-api-key\"\n}"
      },
      {
        "title": "方式二：环境变量",
        "body": "export BOCHA_API_KEY=\"sk-your-api-key\"\n\nAPI Key 获取：https://open.bochaai.com → API KEY 管理"
      },
      {
        "title": "使用方法",
        "body": "node scripts/search.js <query> [options]"
      },
      {
        "title": "参数说明",
        "body": "参数类型必填说明<query>string✅搜索关键词--count <n>number❌返回结果数量，范围 1-50，默认 10--freshness <v>string❌时间范围过滤，默认 noLimit--summaryflag❌是否返回网页摘要"
      },
      {
        "title": "freshness 取值说明",
        "body": "值说明noLimit不限时间 (默认，推荐)oneDay一天内oneWeek一周内oneMonth一个月内oneYear一年内YYYY-MM-DD..YYYY-MM-DD自定义日期范围，如 2025-01-01..2025-04-06YYYY-MM-DD指定日期，如 2025-04-06\n\n⚠️ 推荐使用 noLimit，搜索算法会自动优化时间范围。指定时间范围可能导致无结果。"
      },
      {
        "title": "基本搜索",
        "body": "node scripts/search.js \"沪电股份\""
      },
      {
        "title": "限制数量",
        "body": "node scripts/search.js \"人工智能\" --count 5"
      },
      {
        "title": "带摘要",
        "body": "node scripts/search.js \"DeepSeek\" --summary"
      },
      {
        "title": "限定时间范围",
        "body": "node scripts/search.js \"AI新闻\" --freshness oneWeek --count 10"
      },
      {
        "title": "组合使用",
        "body": "node scripts/search.js \"阿里巴巴ESG报告\" --count 5 --freshness oneMonth --summary"
      },
      {
        "title": "成功响应",
        "body": "{\n  \"type\": \"search\",\n  \"query\": \"搜索词\",\n  \"totalResults\": 12345,\n  \"resultCount\": 10,\n  \"results\": [\n    {\n      \"index\": 1,\n      \"title\": \"网页标题\",\n      \"url\": \"https://example.com/page\",\n      \"description\": \"网页内容的简短描述\",\n      \"summary\": \"网页内容的详细摘要 (需 --summary)\",\n      \"siteName\": \"网站名称\",\n      \"publishedDate\": \"2025-01-01T12:00:00+08:00\"\n    }\n  ]\n}"
      },
      {
        "title": "错误响应",
        "body": "{\n  \"type\": \"error\",\n  \"code\": \"401\",\n  \"message\": \"Invalid API KEY\",\n  \"log_id\": \"xxxx\"\n}"
      },
      {
        "title": "常见错误码",
        "body": "错误码说明处理方式400参数缺失检查 query 参数401API Key 无效检查 config.json 或环境变量403余额不足前往 open.bochaai.com 充值429请求频率限制稍后重试"
      },
      {
        "title": "API 文档",
        "body": "博查开放平台：https://open.bochaai.com\nAPI 文档：https://bocha-ai.feishu.cn/wiki/RXEOw02rFiwzGSkd9mUcqoeAnNK"
      }
    ],
    "body": "博查搜索 (Bocha Search)\n\n基于博查 AI 搜索 API 的网页搜索插件，返回结构化的搜索结果，适合大模型使用。\n\n功能特点\n🔍 全网搜索，结果准确\n📝 可选返回网页摘要 (summary)\n⏰ 支持时间范围过滤\n🌐 Response 格式兼容 Bing Search API\n配置\n方式一：配置文件 (推荐)\n\n编辑 config.json：\n\n{\n  \"apiKey\": \"sk-your-api-key\"\n}\n\n方式二：环境变量\nexport BOCHA_API_KEY=\"sk-your-api-key\"\n\n\nAPI Key 获取：https://open.bochaai.com → API KEY 管理\n\n使用方法\nnode scripts/search.js <query> [options]\n\n参数说明\n参数\t类型\t必填\t说明\n<query>\tstring\t✅\t搜索关键词\n--count <n>\tnumber\t❌\t返回结果数量，范围 1-50，默认 10\n--freshness <v>\tstring\t❌\t时间范围过滤，默认 noLimit\n--summary\tflag\t❌\t是否返回网页摘要\nfreshness 取值说明\n值\t说明\nnoLimit\t不限时间 (默认，推荐)\noneDay\t一天内\noneWeek\t一周内\noneMonth\t一个月内\noneYear\t一年内\nYYYY-MM-DD..YYYY-MM-DD\t自定义日期范围，如 2025-01-01..2025-04-06\nYYYY-MM-DD\t指定日期，如 2025-04-06\n\n⚠️ 推荐使用 noLimit，搜索算法会自动优化时间范围。指定时间范围可能导致无结果。\n\n示例\n基本搜索\nnode scripts/search.js \"沪电股份\"\n\n限制数量\nnode scripts/search.js \"人工智能\" --count 5\n\n带摘要\nnode scripts/search.js \"DeepSeek\" --summary\n\n限定时间范围\nnode scripts/search.js \"AI新闻\" --freshness oneWeek --count 10\n\n组合使用\nnode scripts/search.js \"阿里巴巴ESG报告\" --count 5 --freshness oneMonth --summary\n\n输出格式\n成功响应\n{\n  \"type\": \"search\",\n  \"query\": \"搜索词\",\n  \"totalResults\": 12345,\n  \"resultCount\": 10,\n  \"results\": [\n    {\n      \"index\": 1,\n      \"title\": \"网页标题\",\n      \"url\": \"https://example.com/page\",\n      \"description\": \"网页内容的简短描述\",\n      \"summary\": \"网页内容的详细摘要 (需 --summary)\",\n      \"siteName\": \"网站名称\",\n      \"publishedDate\": \"2025-01-01T12:00:00+08:00\"\n    }\n  ]\n}\n\n错误响应\n{\n  \"type\": \"error\",\n  \"code\": \"401\",\n  \"message\": \"Invalid API KEY\",\n  \"log_id\": \"xxxx\"\n}\n\n常见错误码\n错误码\t说明\t处理方式\n400\t参数缺失\t检查 query 参数\n401\tAPI Key 无效\t检查 config.json 或环境变量\n403\t余额不足\t前往 open.bochaai.com 充值\n429\t请求频率限制\t稍后重试\nAPI 文档\n博查开放平台：https://open.bochaai.com\nAPI 文档：https://bocha-ai.feishu.cn/wiki/RXEOw02rFiwzGSkd9mUcqoeAnNK"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/sunjingji/bocha-search",
    "publisherUrl": "https://clawhub.ai/sunjingji/bocha-search",
    "owner": "sunjingji",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bocha-search",
    "downloadUrl": "https://openagent3.xyz/downloads/bocha-search",
    "agentUrl": "https://openagent3.xyz/skills/bocha-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bocha-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bocha-search/agent.md"
  }
}