funda-data

Funda AI 技能

Funda AI 提供两个互补的接口，它们由同一数据源提供支持：

接口	适用场景	身份验证	输出
MCP agent_chat，地址为 https://funda.ai/api/mcp	研究、分析、综合	OAuth（通过 claude mcp add 自动完成）	综合文本及免责声明
REST /v1/*，地址为 https://api.funda.ai	原始结构化数据	FUNDA_API_KEY Bearer	JSON

两者都需要有效的 Funda AI 订阅。

---

步骤 1：选择接口

用户需求	接口
DCF / 可比公司分析讲解、行业观点、电话会记录综合、公司简介	MCP
带有判断的财报预览/回顾、超预期或不及预期的拆解、叙事框架	MCP
实时或日内报价、日终价格历史	REST
原始期权链快照、希腊值、GEX 时间序列	REST
财务报表中的特定单项（单个数字、JSON）	REST
13F 文件、内部人交易、国会成员交易的逐行数据	REST
带结构化情绪分析/事件时间线的新闻（JSON）	REST
批量数据集下载	REST
AI 公司招聘信号（OpenAI、Anthropic、Google、xAI）	REST

对于含糊不清的研究类问题，默认使用 MCP。当用户需要机器可读的结构化数据时，使用 REST；MCP 拒绝处理时（实时价格、原始报价）也使用 REST。

MCP 还会拒绝提供买入/卖出建议、目标价、个性化投资组合建议、税务/法律建议以及交易执行。这些都不属于任何一个接口的服务范围——请礼貌拒绝，不要转而尝试 REST，希望得到不同的答案。

---

步骤 2：MCP 流程（研究）

2a. 确认 MCP 已连接

!`claude mcp list 2>/dev/null | grep -iE "^funda:" || echo "FUNDA_MCP_NOT_CONNECTED"`

• 如果出现以 funda: 开头的行 → 已注册。可将该工具作为 mcp__funda__agent_chat 调用。继续。
• FUNDA_MCP_NOT_CONNECTED → 请用户安装：

  claude mcp add --transport http funda https://funda.ai/api/mcp
  

  随后会打开浏览器标签页，以供用户通过 OAuth 授权（1 小时令牌 + 30 天刷新令牌，自动管理）。Claude Code 会话可能需要重启后，工具才会注册。

2b. 明确问题

agent_chat 每次都会开始一个全新的研究回合，不会记住不同调用之间的内容——请在问题文本中写明股票代码、时间范围和假设。

用户需求	问题示例
财报预览	“预览 MSFT 周四发布的 Q3 财报——分析各业务板块趋势、市场一致预期中偏激进或偏保守的部分，以及超预期/不及预期的模式。”
财报回顾	“分析 NVDA 的 Q2 财报：各业务板块的超预期/不及预期情况、业绩指引与市场一致预期的对比，以及电话会问答中关于数据中心需求的内容。”
深入分析行业	“总结 2026 年超大规模云服务商的资本支出周期——按公司列出支出层级、供应商敞口及其对毛利率的影响。”
供应链	“梳理 TSMC 的客户集中度和 N2 爬坡风险——按营收列出前三大敞口。”
文件摘要	“对比 PLTR 最新 10-K 与上一年度文件中的新增风险因素。”
DCF	“假设数据中心增长率为 25%、终值利润率为 10%、WACC 为 9%，对 NVDA 进行 DCF 分析——展示敏感性分析表。”
宏观	“美国处于达利欧长期债务周期的哪个阶段？这对久期配置有何影响？”
持仓情况	“根据最新的 13F 文件，CRWD 的机构持仓是否发生变化——机构是净买入还是净卖出？”

如果用户只提供了股票代码，请先提出一个澄清问题，明确本次研究范围（财报预览？回顾？公司简介？DCF？），然后再调用工具——含糊的问题会浪费一次调用机会，得到的回答也会很笼统。

如果用户是在追问之前 Funda 的回复，请将相关段落引用到新问题中；Agent 不会记住之前的调用内容。

如需查看各主题的更多问题示例，请参阅 references/research-topics.md。

2c. 调用工具

mcp__funda__agent_chat(question: "<full research question>")

典型运行时间为 15–60 秒；服务会持续推送进度通知，因此客户端不会超时。

响应格式：

• content[0].text — 答案以 [Funda research output — fundamental analysis, informational only…] 为前缀。请保留此前缀。
• _meta["funda.io/conversation_id"] — UUID。应用内历史记录页面为 https://funda.ai/agent-chat?c=<id>（/agent-chat 路由会重定向至 /agent-chat-v2?c=<id>）。
• _meta["funda.io/timed_out"] — 如果 Agent 达到运行预算，则值为 true。答案不完整；请提出缩小范围后重试。

如果调用返回 403 subscription_required，则表示 MCP 已注册，但该账户尚未订阅——请引导用户前往 https://funda.ai 激活。

每次调用都会消耗一次研究额度。如果首次答案合理，不要仅为了换一种提问方式而再次调用。

---

步骤 3：REST 流程（原始数据）

3a. 解析 FUNDA_API_KEY

该技能按以下顺序解析 FUNDA_API_KEY：

1. FUNDA_API_KEY 环境变量
2. 当前目录 .env 文件中的 FUNDA_API_KEY
3. git 仓库根目录 .env 文件中的 FUNDA_API_KEY（这样 worktree 会继承主检出目录中的密钥）

!`if [ -n "$FUNDA_API_KEY" ]; then echo "KEY_FROM_ENV_VAR"; elif [ -f .env ] && grep -qE "^FUNDA_API_KEY=" .env; then echo "KEY_FROM_LOCAL_DOTENV:$(pwd)/.env"; else GIT_COMMON=$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null); if [ -n "$GIT_COMMON" ]; then ROOT=$(dirname "$GIT_COMMON"); if [ -f "$ROOT/.env" ] && grep -qE "^FUNDA_API_KEY=" "$ROOT/.env"; then echo "KEY_FROM_ROOT_DOTENV:$ROOT/.env"; else echo "KEY_NOT_SET"; fi; else echo "KEY_NOT_SET"; fi; fi`

然后根据解析结果采取相应操作：

• KEY_FROM_ENV_VAR — 在 curl 调用中直接使用 $FUNDA_API_KEY。
• KEY_FROM_LOCAL_DOTENV:<path> / KEY_FROM_ROOT_DOTENV:<path> — 调用前加载一次：

  export FUNDA_API_KEY=$(grep -E "^FUNDA_API_KEY=" <path> | head -1 | cut -d= -f2- | sed 's/^["'\'']//;s/["'\'']$//')
  

• KEY_NOT_SET — 向用户索要密钥。用户可以执行 export FUNDA_API_KEY="..."，也可以将 FUNDA_API_KEY=... 添加到仓库根目录的 .env 文件中（对 worktree 来说更推荐此方式）。

3b. 查找合适的端点

根据用户请求匹配类别，并阅读相应的参考文件，了解完整参数和响应架构。

类别	端点系列	参考文档
实时 / 批量 / 盘后行情报价	/v1/quotes?type=...	references/market-data.md
历史 EOD、日内 K 线、技术指标	/v1/stock-price、/v1/charts	references/market-data.md
大宗商品 / 外汇 / 加密货币行情报价	/v1/quotes?type=commodity-quotes	references/market-data.md
利润表 / 资产负债表 / 现金流 / 指标 / 比率	/v1/financial-statements	references/fundamentals.md
公司概况、同行、流通股、搜索、筛选器、列表	/v1/company-profile、/v1/company-details、/v1/search、/v1/companies	references/fundamentals.md
分析师预估、目标价、评级、DCF、评级	/v1/analyst?type=...	references/fundamentals.md
期权链、希腊值、GEX、IV、最大痛点、交易流、筛选器	/v1/options/...	references/options.md
供应链 KG：供应商、客户、竞争对手、合作伙伴	/v1/supply-chain/...	references/supply-chain.md
Twitter、Reddit、Polymarket、政府交易、持股情况	/v1/twitter-posts、/v1/reddit-posts、/v1/polymarket/...、/v1/government-trading、/v1/ownership	references/alternative-data.md
AI 增强新闻 + 汇总情绪 + 事件时间线	/v1/news/ticker、/v1/news/timeline、/v1/news/sentiment	references/news-enriched.md
SEC 文件、财报 / 播客文字稿、研究报告	/v1/sec-filings、/v1/transcripts、/v1/investment-research-reports	references/filings-transcripts.md
财报 / 股息 / IPO / 拆股 / 经济日历	/v1/calendar?type=...	references/calendar-economics.md
国债利率、GDP/CPI 指标、FRED、风险溢价	/v1/economics、/v1/fred	references/calendar-economics.md
股票新闻、涨幅榜 / 跌幅榜、ETF 持仓、ESG、COT、批量数据、市场时段	/v1/news、/v1/market-performance、/v1/funds、/v1/esg、/v1/cot-report、/v1/bulk、/v1/market-hours	references/other-data.md
AI 公司招聘信号（OpenAI、Anthropic、Google、xAI、Mercor、SurgeAI）	/v1/recruit-...	references/recruit.md
通过 Bedrock 代理 Claude API	/v1/claude/v1/messages	references/claude-proxy.md

3c. 调用端点

curl -s -H "Authorization: Bearer $FUNDA_API_KEY" \
  "https://api.funda.ai/v1/<endpoint>?<params>" | python3 -m json.tool

所有响应均为 {"code": "0", "message": "", "data": ...}。非零的 code 表示错误，请查看 message。

列表端点采用分页：{"items": [...], "page": 0, "page_size": 20, "next_page": 1, "total_count": N}。页码从 0 开始；没有更多页面时，next_page 为 -1。

对于较全面的股票概览（例如“介绍一下 AAPL”），可结合几次 REST 调用：/v1/company-profile 用于获取行业/CEO/市值/价格，/v1/financial-statements?type=key-metrics-ttm 和 /v1/analyst?type=price-target-summary。

---

第 4 步：回复用户

• 对于 MCP 综合分析：用结构化形式（表格、项目符号、标题）呈现，不要直接倾倒原始数据。保留 Funda 免责声明；切勿将分析包装成建议、目标价或交易信号。
• 对于 MCP 响应，请引用 https://funda.ai/agent-chat?c={conversation_id}，方便用户查看 Agent 的完整时间线。
• 对于 REST 响应，请规范地格式化数字（价格保留 2 位小数，比率保留 2-4 位，大数使用千位分隔符或 $2.8T 这样的缩写）。比较数据请使用表格；总结趋势，而非直接倾倒时间序列。
• 对于 DCF / 估值分析，请展示 Funda 使用的假设，方便用户调整。
• 注明来源：“Funda AI”（无论使用 MCP 还是 REST）。
• 切勿提供交易建议——呈现数据，让用户自行得出结论。

---

参考文件

MCP 路径：

• references/research-topics.md — 分类示例问题，以及如何组织 agent_chat 查询的提示。

REST 路径：

• references/market-data.md — 报价、历史价格、图表、技术指标
• references/fundamentals.md — 财务报表、公司简介/详情、搜索/筛选、分析师、公司列表
• references/options.md — 期权链、希腊值、GEX、交易流、IV、筛选器、合约级数据
• references/supply-chain.md — 供应链 KG、关系、图遍历
• references/alternative-data.md — Twitter、Reddit、Polymarket、政府交易、持仓
• references/news-enriched.md — AI 增强新闻、事件时间线、汇总情绪
• references/filings-transcripts.md — SEC 文件、财报/播客文字记录、研究报告
• references/calendar-economics.md — 日历、经济数据、国债、FRED
• references/other-data.md — 新闻、市场表现、基金、ESG、COT、批量数据、市场交易时间
• references/recruit.md — AI 公司招聘信号、JD 分类、产品集群、发布概率
• references/claude-proxy.md — 通过 Bedrock 使用 Claude API 代理