> ## Documentation Index
> Fetch the complete documentation index at: https://www.bazhuayu.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 2026 年 8 月更新日志
> 2026 年 8 月八爪鱼文档更新，包含 DataHub 产品介绍与新手教程、CLI v0.1.33 与 OpenAPI API Key 认证说明。
# 采集学院：网页空白排错
> **文档同步日期：** 2026 年 8 月 31 日
“采集学院 → 操作指南 → 规则排错与优化 → 流程优化”新增网页空白的排错方法，位于“自动重试”之后。页面说明详情页出现 `about:blank` 的常见原因、Ajax 加载设置方式，以及无法返回列表页时添加“返回上一级网页”步骤的解决方法。
# DataHub MCP 能力说明
> **文档同步日期：** 2026 年 8 月 28 日
DataHub 栏目新增 DataHub MCP 能力说明，梳理通用 MCP 的 6 个稳定工具、同步与异步运行、结果分页、`handoff` 大结果处理和取消任务规则。Data App 会随市场更新，实际使用时应通过 `search_data_apps` 与 App 详情实时确认。
# 八爪鱼采集器 MCP 工具与工作流同步
> **文档同步日期：** 2026 年 8 月 28 日
八爪鱼采集器 MCP 当前主入口实测公开 12 个工具。文档新增 [`get_task_status`](/docs/zh/mcp/get-task-status) 和 [`describe_ecommerce_dataset`](/docs/zh/mcp/describe-ecommerce-dataset) 页面，并将模板云采集主流程更新为：`search_templates` 精确读取实时模板契约 → `execute_task` 自动检查并启动 → `get_task_status` 获取状态与 `lotNo` → `export_data` 分页读取或使用签名链接下载。
同步修正了模板搜索的 `query` 参数和 `sourceTree` 选项规则、导出的 `taskId + lotNo + page/pageSize` 契约，以及 Temu / TikTok Shop 从任务提交、结果集描述到查询的流程。客户端验证、Coze / Dify 提示词、速率限制与故障排查不再将 `validateOnly`、MCP Tasks 或旧导出字段描述为当前接口。
# DataHub 通用 MCP 连接与选 App 模式
> **文档同步日期：** 2026 年 8 月 28 日
DataHub“Agent 连接”新增 通用连接：在 Agent 中选择 App。通用模式不需要预先选择 Data App：用户先连接 DataHub MCP，再由 Agent 搜索市场、查看 App 详情、确认参数并运行。页面完整说明 API Key 与 OAuth 两种认证方式、WorkBuddy 授权、搜索提示词、异步结果查询和常见问题。
原有两篇教程同步明确为“先选 App，再连接”的固定能力模式，并分别更名为 Codex：连接指定 App 与 WorkBuddy：连接指定 App。用户现在可以根据需求选择“先连接后搜索”或“先选 App 后连接”，两种方式调用的都是 DataHub Data App。
# DataHub 新手入门教程
> **文档同步日期：** 2026 年 8 月 26 日
DataHub 栏目新增新手入门教程，完整说明登录市场、在线体验 Data App，以及通过 MCP 将 Data App 接入 AI Agent 的流程。当前内容包括 客户端直接使用、通用连接、Codex：连接指定 App和WorkBuddy：连接指定 App。
# DataHub 产品介绍
> **文档同步日期：** 2026 年 8 月 25 日
文档站顶部导航新增 **DataHub** 栏目，位于“采集学院”和“MCP 服务”之间。首发页面介绍 DataHub 如何将采集模板、存量数据、第三方接口和数据处理能力统一封装为 Data App，供 Agent、业务系统和用户通过网站门户、API、MCP 或 SDK 使用。
页面同步说明了 Data App 的机器可读描述、输入输出、在线体验、按量计费和发布者/应用名标识，并补充价格监测、内容趋势、招投标、招聘研究、周期报表和 AI 取数等典型场景。当前可从 Data Hub 市场浏览已上线能力，并通过 客户端直接使用、通用连接或指定 App 教程了解在线体验与 MCP 接入流程。
# 采集学院视频专区
> **文档同步日期：** 2026 年 8 月 24 日
“采集学院”顶部导航现使用原生菜单区分“图文”和“视频”。视频内容按“界面介绍、操作指导、问题排查、操作实践、直播回放”分层展示；各视频保留独立详情页和云端 HTML5 播放器，无需将视频文件提交到文档仓库。
本轮已迁移视频专区中除 XPath 相关内容以外的现有教程。详情页已移除标题下方的重复教程说明，仅保留视频播放器与返回分类页的链接，使页面阅读更简洁。
# 文档链接审核与跳转修复
> **文档同步日期：** 2026 年 8 月 24 日
中文文档正文中的本站、旧帮助中心和外站链接现统一在新标签页打开，并使用 `noopener noreferrer` 安全属性。旧帮助中心可点击链接已映射至当前文档站的对应教程、视频详情页或已存在的学院入口，不再跳转到旧站；导航、Card、代码示例和 `source` 追溯元数据保持原有行为。
后续可运行 `npm run docs:links:check` 审核链接，运行 `npm run docs:links:fix` 执行修复。映射报告输出至 `reports/document-link-audit.json`，用于复核未能一对一对应的历史教程链接。
# CLI v0.1.33
> **更新日期：** 2026 年 8 月 7 日
> 当前安装版本：`bazhuayu-cli@0.1.33`
```bash theme={null}
npm install -g bazhuayu-cli@0.1.33
bazhuayu --help
```
本次更新重写了 `bazhuayu --help`：命令按 Create、Run、Manage、Data 和 Config 分类展示，发布版不再在帮助中暴露 `env`、`runs` 等内部开发命令。`bazhuayu capabilities --help` 现在只显示帮助文字；Agent 和自动化流程应继续使用稳定的 `bazhuayu capabilities --json` 读取机器契约。
模板市场同步更新：搜索结果按公开 `templateId` 全局去重并在去重后分页，同一模板的多语言记录只保留排序靠前的名称；总数表示唯一模板数量。CLI 参数、帮助和公开 JSON 输出统一使用 `templateId`，新脚本不应再使用 `--template-registration-id`，也不应依赖 `templateRegistrationId`、`status`、`raw` 等内部字段。后端所需的注册 ID 映射由 CLI 在内部处理。
`task list` 新增 `--status`、`--task-type` 和 `--scheduled true|false` 筛选，可与 `--template-id`、关键词和任务组筛选组合使用。相关文档：CLI 概述、安装与验证、任务管理、命令速查表。
# OpenAPI 支持 API Key 认证
> **文档同步日期：** 2026 年 8 月 3 日
OpenAPI 业务接口现补充 API Key 授权说明。调用时在请求头中传入 `x-api-key: op_sk_xxxxxx`；API Key 与 MCP 使用同一套密钥，可在八爪鱼官网账户中心创建。
交互式 OpenAPI 界面现声明 `x-api-key` 的 API-key security scheme，并保留既有 Access Token 作为兼容认证方式。每个请求只需选择其中一种，不要把 API Key 写成 Bearer Token，也不要将真实密钥提交到代码、截图或日志中。
相关文档：OpenAPI 概述、认证、获取 API Key