Tutorials
教程
从下载数据到让 Agent 自己查价。下面是三条计划中的上手路径，详细步骤正在整理。
01
本地 DuckDB
下载数据集，用 SQL 直接查价格与历史。
查看说明 →02
接入 MCP
把行情接给 Cursor、Claude 或自建 Agent。
查看说明 →03
在 DSH 中使用
配置一次，之后直接用自然语言问价。
查看说明 →1. 本地 DuckDB
适合批量分析、复现结论和做自己的看板。下载 forever-beta.duckdb（七张数据表）后，用 DuckDB 2.x 直接打开即可查询，不需要服务端账号。
- 下载与校验数据集
- 用 DuckDB 打开，浏览
listings/daily_prices等表结构 - 三个常用查询：某物品的日线、市场横截面、样本量分布
- 字段含义与价格口径
详细步骤与示例 SQL 整理中；字段与下载入口见 数据页。
2. 接入 MCP
适合让 Agent 按需点查，不用自己写 SQL。服务端是标准的 Streamable HTTP MCP，任何支持 HTTP transport 的客户端都能连。
- 申请 API Key
- 在客户端里填入 MCP 地址与 Authorization 头
- 第一次调用：先列市场，再搜物品，最后查价
- 读懂
as_of、sample_size与confidence
完整参数与返回契约见 MCP 文档。
3. 在 DSH 中使用
在 DSH 的 MCP 配置里加入本服务，之后就可以直接问「魔纹布现在多少钱」，让 Agent 自己调用工具。
- 在 DSH 配置中加入 MCP server
- 确认四个工具已加载
- 用自然语言提问，检查回答里的时间与样本量
配置片段与演示整理中；协议细节见 客户端配置。
更新进度
| 教程 | 状态 | 预计内容 |
|---|---|---|
| 本地 DuckDB | 整理中 | 下载、打开、示例查询、字段说明 |
| 接入 MCP | 文档已可用 | Key、客户端配置、首次调用 |
| 在 DSH 中使用 | 整理中 | 配置片段、提问示例、结果解读 |