配置文档 / CodeBuddy
MCP Client Guide
从下载安装到用 CodeBuddy 分析数据
适合在开发或自动化助手中接入 RealTrace 数据能力。 这份教程按真实客户路径写：先下载或打开 Agent，学会第一次对话，再创建 RealTrace 数据分析助手，最后接入 MCP 工具。
一、下载或打开 CodeBuddy
先把 Agent 客户端准备好，并确认它可以正常和大模型对话。还没有模型服务或会员权限时，先完成账号登录、模型选择或 API Key 配置。
待补充官方入口- 打开 CodeBuddy 的官方入口或客户端。
- 登录账号，并完成模型或开发环境配置。
- 先创建一个简单任务，确认助手能正常理解和执行。
二、先学会怎么向 Agent 提业务问题
不要只问“查一下这个产品”。更好的提问方式是给出业务目标、数据范围和输出格式，让 Agent 知道要产出什么结论。
跨平台选品对比 Amazon 与 Walmart 上的 portable blender，整理价格带、评价量和可切入机会，用表格输出。
商品诊断分析这个 Amazon ASIN、Walmart num_iid 或 TikTok Shop product_id 的卖点、价格与可改进方向。
内容趋势搜索 TikTok、YouTube 和 Reddit 上关于 puffer jacket 的内容，提炼高频场景、表达方式和用户吐槽。
三、创建一个 RealTrace 数据分析助手
如果 CodeBuddy 支持“助手”“项目”“自定义 GPT”“工作流”或“系统提示词”，建议创建一个专门用于电商和社媒数据分析的助手。下面这段可以直接复制后按你的业务改写。
# 角色
你是 RealTrace 数据分析助手，负责帮助用户用 Amazon、Walmart、TikTok Shop 七区与社媒数据完成选品调研、竞品分析、评论洞察、内容趋势和创作者筛选。
# 使用规则
1. 接入 RealTrace MCP 后，先调用 get_agent_instructions 或读取 realtrace://agent-guide。
2. 有关键词、链接、话题时，先搜索；拿到标准 ID 后，再查详情、评论或创作者信息。
3. 不要把原始 JSON 堆给用户，要输出结论、证据、风险和下一步建议。
4. 结论必须标注来自哪些数据：商品搜索、商品详情、商品评论、社媒帖子、社媒评论、创作者或字幕。
5. 如果用户缺少平台、站点、关键词、商品 ID（ASIN / num_iid / product_id）或输出格式，先提出一个简短澄清问题。
# 输出格式
- 先给一句结论。
- 再用表格列出关键发现和证据。
- 最后给 3-5 条下一步行动建议。四、接入 RealTrace MCP
这一步才是把 RealTrace 的实时数据工具接进 CodeBuddy。登录控制台，在令牌管理中创建或复制 API Key。建议给测试环境和生产环境分别创建 Key，便于追踪用量和控制权限。
https://realtrace.cangxuandata.com/mcp
Authorization: Bearer YOUR_API_KEY- 在 CodeBuddy 的 MCP 或工具配置中新增 RealTrace。
- 填写 Endpoint 和 Bearer Token。
- 保存后运行一次测试查询。
CodeBuddy MCP 配置字段
MCP server: RealTrace
Endpoint: https://realtrace.cangxuandata.com/mcp
Authorization: Bearer YOUR_API_KEY五、让 Agent 学会调用 RealTrace
1 先调用 get_agent_instructions 或读取 realtrace://agent-guide，理解 RealTrace 的工具链规则。2 有关键词或话题时先搜索；有 ASIN、num_iid、product_id、帖子或视频 ID 后再读取详情和评论。3 把原始数据整理成客户能用的结论：机会、风险、证据、候选清单和下一步动作。六、验证是否生效
连接成功后，用下面的问题测试。好的结果应该包含调用过的数据来源、关键发现、可复查的商品或内容线索，以及下一步建议。
请用 RealTrace 查询 desk organizer 的商品和评论，并把结果整理成 JSON 字段：price_range、pain_points、opportunities。
请告诉我你刚才调用了哪些 RealTrace 工具、用了哪些数据来源，并把结论整理成“发现 / 证据 / 建议”的表格。
如果客户端字段名和本文略有不同，只要保证 URL 使用 https://realtrace.cangxuandata.com/mcp，并携带 Authorization: Bearer YOUR_API_KEY，连接逻辑就是一致的。