FinXData

FinXData 用于需要鉴权的金融数据查询。可调用的数据接口与 MCP 工具表面一致，包括 /health、/api/quota/api-key，以及 /api/v1/summary 中列出的当前 GET /api/v1/http/* 接口。

配置

export FINXDATA_API_KEY="sk-..."
export FINXDATA_BASE_URL="https://api.finxdata.ai"
# 仅调用 claw 免费接口时，二选一：
export FINXDATA_OPENCLAW_AGENT_ID="agent-..."
export FINXDATA_HERMES_SESSION_ID="session-..."

FINXDATA_BASE_URL 是可选项。

如果没有设置 FINXDATA_API_KEY，先提示用户需要登录 www.finxdata.ai 申请免费的 API Key，再继续调用需要鉴权的数据接口。health 和 summary 可在没有 API Key 时调用。

claw 命令不需要 API Key，但必须通过 --openclaw-agent-id、--hermes-session-id 或对应环境变量提供来源标识。 claw 命令当前支持获取的数据包括： | 命令 | 接口 | 参数 | 内容 | |---|---|---|---| | claw market-price | /api/v1/http/claw/market/price | code，支持多个；另需 --openclaw-agent-id 或 --hermes-session-id | 指数或板块行情。 | | claw track-news | /api/v1/http/claw/track/news | 另需 --openclaw-agent-id 或 --hermes-session-id | 新闻跟踪快照。 | | claw track-market | /api/v1/http/claw/track/market | 另需 --openclaw-agent-id 或 --hermes-session-id | 市场跟踪快照。 | | claw ontology-abstract | /api/v1/http/claw/ontology/abstract | code；另需 --openclaw-agent-id 或 --hermes-session-id | 股票图谱摘要，不返回实体和关系明细。 | | claw financial | /api/v1/http/claw/financial | code；另需 --openclaw-agent-id 或 --hermes-session-id | 股票业绩报表简版。 |

调用流程

优先使用内置封装脚本：

python3 scripts/finxdata.py summary
python3 scripts/finxdata.py quota
python3 scripts/finxdata.py stock quote --code 600519
python3 scripts/finxdata.py stock financial --code 600519 --sections reports,mainops
python3 scripts/finxdata.py stock ontology --code 600519
python3 scripts/finxdata.py market price --code 000001 BK0477
python3 scripts/finxdata.py claw market-price --code 000001 BK0477 --openclaw-agent-id agent-demo
python3 scripts/finxdata.py claw track-news --hermes-session-id session-demo
python3 scripts/finxdata.py claw track-market --hermes-session-id session-demo
python3 scripts/finxdata.py claw ontology-abstract --code 600519 --openclaw-agent-id agent-demo
python3 scripts/finxdata.py claw financial --code 300223 --openclaw-agent-id agent-demo
python3 scripts/finxdata.py market hot-stocks --limit 100
python3 scripts/finxdata.py track news
python3 scripts/finxdata.py track market
python3 scripts/finxdata.py track notice

封装脚本会输出 API 返回的 JSON；大多数数据接口返回 {"code": 200, "data": "<Markdown>"}。脚本已内置网络重试、超时控制和常见 HTTP 错误的友好提示。

按这个顺序处理用户请求：

需要确认接口能力时，先运行 summary，再选择具体命令。
需要查询数据时，调用最窄的接口和参数；多股票报价或指数价格优先一次传多个 code。
查询失败时，先读脚本返回的 code 和 message，不要把 curl 或堆栈错误直接抛给用户。
返回给普通用户时，优先总结关键字段、日期范围、是否有数据和下一步建议；不要只贴原始 JSON。

参考资料

精简接口列表：读取 references/api.md。
场景示例、更新节奏、配额处理、示例结果和 FAQ：读取 references/usage.md。

规则

普通数据接口需要 X-API-Key；claw 免费接口需要 x-openclaw-agent-id 或 x-hermes-session-id，不扣调用额度。
不确定某个接口是否可用时，先查询 /api/v1/summary。
不描述上游数据源，只描述接口内容、参数、更新时间口径和返回结果。
不把金融数据解释成投资建议；需要判断时说明数据来源于接口返回，结论仅供信息整理。
如果配额不足，先运行 quota，用 daily_remaining、daily_used、daily_max、prepaid_balance、gift_remaining 和 retry_after_seconds 给出可理解的处理建议。
对网络、超时、5xx、429 这类暂时性问题，说明脚本已重试；建议稍后重试、缩小查询范围或检查额度/网络。