Drillr — The financial MCP for AI agents

通过浏览器登录，无需复制 API 密钥。一个托管的 Streamable HTTP 端点，提供十种工具：将名称或描述转换为股票代码，列出并搜索公司的申报文件（包含结构化的申报原始事实和申报文本），对财务数据表运行只读 SQL，并从业绩电话会和新闻中提取研究信号。

⭐ 如果 drillr 对你的 Agent 有帮助，请给我们点个星标——这是我们知道要继续开源开发的方式。

安装 drillr MCP

如需安装或连接 drillr MCP，请阅读官方安装指南。 该指南是客户端专属设置、浏览器 OAuth 登录和连接检查的维护文档。

将以下内容粘贴到你想使用 drillr 的应用中：

Please connect drillr MCP in this app using this installation guide: https://drillr.ai/developer/mcp-install.md. Walk me through sign-in and verify the connection.

公共服务为 drillr-data，地址是 https://gateway.drillr.ai/mcp/data（Streamable HTTP）。 默认使用浏览器 OAuth。指南介绍了客户端专属要求，以及不支持 OAuth 的客户端可使用的 API 密钥备用方案。

手动设置和工具参考请参阅 drillr.ai/docs/mcp。

Agent 技能

配套的 drillr 技能为 MCP 和 REST 添加了研究工作流。连接 MCP 服务无需安装该技能：

npx skills add Little-Grebe-Inc/drillr-skill

分发选项

• Smithery 列表
• 此代码库还提供 Claude Code 插件市场：

/plugin marketplace add Little-Grebe-Inc/drillr-mcp-server
/plugin install drillr

安装插件后，请使用官方指南在所选客户端中登录并验证。

Hello World

“NVDA 最新的 10-K 对供应承诺有哪些说明？过去四个季度的数据中心收入有何变化？”

1. 如果只有公司名称，Agent 会调用 ticker_lookup，再调用 filing_list 查看已索引的内容，然后调用 filing_search——单次调用即可返回申报原始事实（数值、期间、XBRL 概念、访问序列号）以及这些事实所在的段落。
2. 要获取季度序列，Agent 会在 financial_statements 上调用 run_sql。
3. 你会得到一个答案，其中每个数字都标注了对应的申报文件。典型往返耗时为 8–15 秒。

十个工具

每个工具都有一个页面，地址为 https://drillr.ai/docs/mcp/<tool>，其中包含参数、限制和错误格式；服务端的 tools/list 也包含相同的描述。这一组工具刻意保持精简：由 Agent 将它们组合使用。

分组	工具	功能	费用
公司	ticker_lookup	名称、品牌或代码子字符串 → 标准代码，包括历史名称	免费
	company_search	自然语言描述 → 匹配公司及匹配原因；覆盖 US / CN / JP / HK / KR；返回所有匹配结果	3–5 cr
申报文件	filing_list	某代码有哪些已索引的申报文件：财年期间、类型、申报日期	0.1 cr
	filing_search	搜索一家公司的申报文件；同时返回结构化的原始报告数据和申报文件文本	0.1 cr
数据集	list_tables	另类数据类别索引，或最多五个类别下的表	免费
	get_table_schema	单个表的列、类型和使用说明——必需筛选条件、覆盖范围、注意事项	免费
	run_sql	在财务、市场和另类数据表上执行一条只读 PostgreSQL SELECT 查询	0.1 cr
信号	industry_inflections	从许多美国业绩电话会议中综合得出的行业变化：机制、范围、程度、对各公司的影响	1 cr
	ai_adoption	美国业绩电话会议披露的具体企业 AI 应用：工作流、阶段、价值、证据	1 cr
	news_search	对公司和市场新闻进行语义搜索：事件脉络、事件、归属明确的说法	0.2 cr

数据内容

由 drillr 基于一手来源构建：数据取自各市场的官方渠道（SEC EDGAR、cninfo、EDINET）并由内部解析，涵盖公司在网上发布的内容（IR 页面、业绩电话会、新闻）以及 drillr 自行估算的数据。中间不经过任何数据供应商。每个已报告数据都链接到其申报文件中的原文段落。各数据集的来源信息：https://drillr.ai/docs/provenance。

数据集	内容	获取方式	覆盖范围
公司	通过任意名称、代码、ISIN、CIK 或 CUSIP 解析股票代码；按描述发现公司；公司资料（交易所、行业、上市日期、网站、员工人数）	ticker_lookup、company_search；通过 SQL 使用 company_snapshot	美国、中国、日本（发现功能还覆盖中国香港和韩国）
申报文件	申报文件索引，包含表格类型、日期和官方链接；支持 EN / ZH / JA 全文搜索；包含按原始披露记录的事实数据，列明数值、单位、期间、申报文件和位置，并通过知识图谱关联，确保采用正确版本的数据	filing_list、filing_search	美国、中国、日本
财务数据	按各市场标准披露的年度和季度利润表、资产负债表、现金流量表；预先计算的估值、利润率、回报、增长、杠杆和流动性指标	对 financial_statements 运行 run_sql，使用 company_snapshot	美国、日本、中国香港、中国、韩国
价格	日线 / 周线 / 月线 OHLCV、指数、盘前和盘后报价	对 price_volume_history、index_price、equity_extended_rt 运行 run_sql	股票：美国、日本、中国香港、中国、韩国；指数、外汇、加密货币、大宗商品
业绩	包含预期值和实际值的日历；结构化电话会摘要（要点、指引、风险、业务板块、问答）	对 earning_call_calendar、earning_call_summary 运行 run_sql	美国、日本
持股情况	内部人持股与交易（表格 3 / 4 / 5）；机构季度持仓（13F-HR）	对 insider_and_institution_activities 运行 run_sql	美国
事件	8-K 公司事件：高管变动、交易、债务发行、证券发行；13D / G 持股变动	对 executive_change、company_deal_events、debt_issuance、securities_offering 运行 run_sql	美国
高管	包含在任状态的名册；来自 DEF 14A 的年度薪酬	对 executive_profile、executive_compensation 运行 run_sql	美国
分析师	分析师个人评级和目标价变动；共识分布和目标价	对 analyst_ratings、analyst_ratings_consensus 运行 run_sql	美国
信号	drillr 基于引用证据得出的结论：行业拐点、企业 AI 采用情况、跨来源新闻脉络和归属明确的观点	industry_inflections、ai_adoption、news_search	美国（新闻：美国、中国、日本及宏观）
替代数据（二级）	围绕 AI 供应链和宏观经济的 9 个类别、65 张表：能源与电力、数据中心、半导体、算力定价、模型开发、推理经济学、宏观与贸易、预测市场、关键矿产	list_tables → get_table_schema → run_sql	全球

股票代码格式：美国使用裸代码（AAPL），A 股使用 .SH / .SZ（600519.SH），日本使用 .T（6758.T），中国香港使用 .HK（00700.HK），韩国使用 .KS / .KQ（005930.KS）；指数使用 ^GSPC；SQL 中报价代码包含 . 或 ^。数据更新时效：申报文件、持股情况和事件在提交后几分钟内更新；电话会和新闻在几分钟到几小时内更新；报表和分析师数据每日更新。

基准测试：由 drillr MCP 驱动的模型在 Vals Finance Agent 上得分为 94.06 %，drillr 还发布了自己的、可识别重述数据的基准测试 — https://drillr.ai/drillr-benchmark。

REST API

同样的数据通过 29 个类型化 REST 端点提供，适用于脚本和数据流水线 — 只需一个 X-API-KEY 标头，输出为 JSON，并提供公开的 OpenAPI 3.1 契约：

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/income-statements?ticker=AAPL&period=FY&limit=4"

参考文档：https://drillr.ai/docs/api · 契约：https://gateway.drillr.ai/api/v2/openapi.json。较早的 /api/v1/data/* 工具镜像见 docs/rest-api.md 文档。

定价与限制

MCP 和 REST 共用一个积分钱包。免费：注册即送 80 积分。Plus：每月 $29 / 300 积分，Ultra：$99 / 1,500 积分，Enterprise 适用于再分发和 SLA。run_sql 返回 100 行（Ultra 为 500 行），每条语句限时 10 秒，最多同时执行 5 条；company_search 有每日调用上限（20 / 100 / 500）。失败的调用不收费。https://drillr.ai/pricing

不支持的范围

私人或未上市公司 · 链上加密货币指标（仅支持 CEX 价格）· 期权链、订单簿、逐笔数据 · 下单 · drillr 不会生成自己的价格预测。

社区

Discord	WeChat
构建 Agent 研究产品的开发者社区——办公时间、调试帮助、抢先体验。	中文开发者社区——最快获取产品反馈。

许可证

MIT — 参见 LICENSE。