Xaudaily Gold Data — Data skill for Claude Code

黄金读数 Agent 分发包 · Gold Data Reading for AI Agents

给 AI Agent 用的**黄金宏观数据**接入包：一份 Agent Skill 说明书 + 一个零依赖的 MCP server。

• 数据源：xaudaily.com（品牌「黄金读数 / Gold Data Reading · XAU Daily」），纯静态黄金宏观数据仪表盘
• 端点：https://xaudaily.com/readings.json?src=skill-github（JSON，schema xaudaily.readings/v1）
• 许可：CC-BY-4.0（署名 + 附链接）

skill-repo/
├── SKILL.md            # Agent Skill：字段说明、信封约定、常见坑（中文为主，关键段落英文）
├── mcp_server.py       # MCP server：纯 Python 标准库，stdio 传输，两个工具
├── README.md           # 本文件（给人看）
├── LICENSE             # CC-BY-4.0 声明
├── WIDGET.md           # 可嵌入金价徽标的嵌入说明（给你的网站/README 用）
└── examples/
    ├── curl.md         # 可直接复制运行的 curl 示例
    └── python.md       # 只用标准库的 Python 示例

---

这是什么

xaudaily.com 每天 06:30 与 22:40（JST）自动抓取、校验并渲染一批黄金宏观读数，同时把它输出成一份**给机器读的 JSON**。这个仓库把那份额外的机器可读产出包装成 Agent 能直接消费的形态：

• SKILL.md —— 一份 Agent Skills 约定的说明书：端点表、完整字段结构（异构结构逐个列出）、取数示例、数据口径、更新节奏、署名要求、踩过的坑。
• mcp_server.py —— 支持 MCP 的客户端（Claude Desktop 等）挂上就能用的 server，两个工具：get_gold_readings（全量 JSON，可按字段裁剪）与 get_gold_daily_brief（当日 Markdown 简报）。只用 Python 标准库，不装任何第三方包。

为什么值得用它（而不是让 Agent 现抓现猜）

1. 每个字段自带出处与截止日。 每个字段里有 source（数据来源）和 asOf/date（数据截止日），meta 里还有口径说明、免责声明与署名要求。Agent 引用时能给出可核查的出处，而不是一个来路不明的数字。
2. 降级是显式的。 某个上游源抓取失败时，站点沿用上一次成功值并把该字段标成 stale: true —— 消费方能看出「这不是最新一期」，而不是被悄悄喂了旧数字。
3. 字段稳定、结构有版本。 顶层 schema 恒为 xaudaily.readings/v1，改结构时会换值；extra 区可以加新字段而不动顶层键，所以你的代码不容易因为上游加字段而挂掉。
4. 单次抓取就够。 金价、沪金、CPI、PCE、非农、PPI、DXY、美债 10Y/30Y、VIX、SPDR 持仓、联邦基金利率、FOMC 决议概率、央行购金、原油、美国债务、驱动因子评分与事件预判，全在一次请求里（约 60 KB），不用拼十几个来源。
5. 零依赖 = 不会腐烂。 mcp_server.py 是单个 stdlib-only 的 Python 文件，没有 requirements，几年后照样能跑。

安装

方式一：作为 Agent Skill

把本目录（或其中的 `SKILL.md`）放进你的 Agent 运行时的 skills 目录即可 —— Agent Skills 约定是「一个目录一份技能，入口是 `SKILL.md`」：

git clone <本仓库地址> gold-market-readings
cp -r gold-market-readings ~/.your-agent/skills/gold-market-readings/
# 或者直接把 SKILL.md 放到你现有的 skills 目录下

Agent 会读它的 frontmatter