典枢 MCP 使用手册

本文档面向用户，介绍 dianshu-mcp 的全部功能、触发词和典型使用场景。

一、总览

典枢 MCP 提供典枢数据交易平台的完整操作能力，共 19 个工具，分为 4 类：

二、账户与登录

2.1 扫码登录（默认方式）

触发词：登录、扫码、登录典枢

流程：Agent 调用 get_login_qrcode，二维码直接显示在聊天窗口中 → 微信扫码 → Agent 调用 wait_login 等待完成 → 登录成功。

使用场景：首次使用、登录过期后重新登录。

2.2 浏览器登录（支持密码）

触发词：密码登录、用账号密码登录、打开浏览器登录

流程：Agent 调用 open_login_browser，弹出浏览器窗口 → 在浏览器中选择微信扫码或输入账号密码 → 登录完成后自动获取凭证。

使用场景：无法微信扫码时（如电脑端微信未登录），使用账号密码方式。

2.3 检查登录状态

触发词：自动触发（每次会话开始、每次操作前）

流程：Agent 自动调用 check_login_status，确认是否已登录。

使用场景：无需用户主动触发，Agent 自动执行。用户可问「我登录了吗」手动检查。

2.4 切换账号

触发词：切换账号、退出登录、换号

流程：Agent 调用 delete_cookies 清除登录态 → 引导重新登录。

2.5 手动设置 Token（高级）

触发词：几乎不触发。

流程：用户在浏览器登录典枢 → 从 localStorage 复制 token 值 → 告诉 Agent「token 是 xxx」→ Agent 调用 set_token 保存。

使用场景：扫码和密码都无法使用时的高级备选方案，普通用户无需关注。

三、订单与下载

3.1 查看已购数据

触发词：我的数据、已购数据、我买了什么、可以下载什么、我的订单

流程：Agent 调用 list_downloads → 列出所有可下载的数据产品。

返回内容：数据集名称、任务编号（taskCode）、状态。

使用场景：想看看自己买过哪些数据，哪些可以下载。

3.2 下载数据

触发词：下载 xxx、下载数据、帮我下那个 xxx

流程：Agent 调用 download_order（需提供 taskCode）→ 自动上链存证 → 下载加密文件 → 解密 → 输出到本地。

返回内容：文件保存路径。

使用场景：已购买数据后想下载到本地。支持同时下载多个。

3.3 查订单

触发词：我的订单、待支付订单、查 PXXX 订单

流程：Agent 调用 list_orders → 展示订单列表。

使用场景：查看订单状态，确认是否支付成功。

3.4 查看已购 API

触发词：我的 API、已购 API、买了什么 API

流程：Agent 调用 list_purchased_apis → 列出已购 API 及剩余额度。

使用场景：查看自己买了哪些数据 API，还剩多少调用次数。

3.5 查看 API 参数

触发词：API 参数、怎么调用、需要什么参数

流程：Agent 调用 get_api_detail（需提供 apiId）→ 展示参数字段列表。

使用场景：调用 API 前了解需要填写哪些参数。

3.6 调用 API

触发词：调用 xxx API、帮我查一下 xxx、用 API 查

流程：

1. Agent 先调用 get_api_detail 获取参数列表，展示给用户
2. 用户逐项填写参数
3. Agent 调用 call_api 执行调用
4. 结果保存到本地并展示

使用场景：调用已购的数据 API（如小红书数据、企业信息等）。

⚠️ 部分需要参数的API接口，需由用户给出具体参数。

四、数据集搜索

4.1 搜索数据集

触发词：搜索、找数据、有没有 xxx 数据、搜一下 xxx

流程：Agent 调用 search_datasets（传入关键词）→ 展示搜索结果列表，含名称、价格、卖家、链接。

智能重试：搜索结果 ≤ 3 条时，Agent 自动对关键词分词后重试。例如「AI agent教程」搜不到 → 自动搜「agent教程」。

使用场景：在典枢市场找想要的数据。

4.2 查看数据集详情

触发词：看看详情、详情、这个数据集怎么样

流程：Agent 调用 dataset_detail（传入 datasetId）→ 展示描述、大小、格式、价格等信息。

使用场景：搜索结果中有感兴趣的数据集，点进去看详细信息和封面图。

4.3 首页推荐

触发词：推荐、热门数据、有什么好数据

流程：Agent 调用 homepage_recommend → 展示平台推荐的热门数据集。

使用场景：不知道搜什么，随便逛逛。

4.4 我发布的数据

触发词：我发布的、我上传的数据、我的数据集

流程：Agent 调用 my_datasets → 展示自己发布过的数据列表。

使用场景：查看自己在平台发布过哪些数据。

五、个人与钱包

5.1 查余额

触发词：余额、钱包、我有多少钱

流程：Agent 调用 get_my_wallet → 展示余额。

5.2 查交易记录

触发词：账单、交易记录、收支明细、充值记录

流程：Agent 调用 list_wallet_transactions → 展示交易历史。

5.3 查个人资料

触发词：我的资料、个人信息

流程：Agent 调用 get_my_profile → 展示昵称和头像。

六、智能路由

当你说话时，Agent 会根据意图自动选择工具。以下是常见问答的对应关系：

七、典型场景

场景 1：初次使用

你说：登录
Agent：展示二维码
你：微信扫码
Agent：登录成功！当前账号：xxx。你可以说「我的数据」查看已购数据。

场景 2：下载已购数据

你说：我的数据
Agent：你已购买 3 个数据集：1. xxx（taskCode: T001）2. yyy（taskCode: T002）...
你说：下载 T001
Agent：开始下载...✅ 下载完成：~/Downloads/dianshu-mcp/downloads/xxx.zip

场景 3：搜索并购买

你说：搜天气数据
Agent：找到 5 个结果：1. 气象数据集（5 元）2. ...
你说：看看第一个详情
Agent：气象数据集，大小 2GB，格式 CSV...购买链接：https://dianshudata.com/dataDetail/123
你说：好的我去买
（在网站购买后）
你说：下载 T003
Agent：✅ 下载完成

场景 4：调用 API

你说：我的 API
Agent：已购 API：1. 小红书数据（23/100 次）
你说：调用小红书 API
Agent：请填写以下参数：1. keyword（搜索关键词，必填）2. page（页码，选填）
你说：keyword=AI，page=1
Agent：✅ 调用成功，结果已保存：~/Downloads/dianshu-mcp/api-data/小红书_20260810.json