StockDrifts

StockDrifts MCP 服务

为 AI Agent 提供持仓数据：获评级的美国 13F 基金及其平均买入价、标准化公司 KPI、日本大股东申报及投资者评级，以及韩国内部人士买入记录。

• 托管端点： https://mcp.stockdrifts.io/mcp/（Streamable HTTP）
• 工具： 32 个，均为只读
• 身份验证： 通过 bearer 标头发送 API 密钥
• 文档： https://www.stockdrifts.io/api-docs
• 注册表名称： io.stockdrifts/mcp

此代码库包含连接配置、注册表清单和一个 Agent 技能。服务本身由 StockDrifts 托管；无需构建或运行任何内容。

数据有何不同

数据集	可获取的数据	来源
获评级的 13F 基金	13F 申报机构的星级评级、按季度划分的持仓、季度环比变化、行业敞口，以及各基金每个持仓的平均买入价	SEC 13F 申报文件
公司 KPI	每个股票代码对应的公司特定运营指标，例如分部收入、客户数、净收入留存率和积压订单，并提供季度和年度序列	公司申报文件
日本投资者	按股票和投资者划分的大额持股（5% 规则）报告、带星级评级的投资者排行榜，以及多个投资者同时申报持股报告的股票	EDINET
韩国内部人士	高管和主要股东交易、内部人士买入和卖出排行榜、内部人士排行榜，以及与实际执行交易相匹配的预先披露交易计划	DART

日本的 5% 规则报告是大股东的申报文件，不同于美国董事和高管交易报告。

连接

你需要一个 API 密钥。请在 https://app.stockdrifts.io/settings/api-keys 创建密钥（Ultra 套餐包含 API 和 MCP 访问权限，详见定价）。

将下面代码片段中的 sd_live_... 替换为你的密钥，并确保任何包含该密钥的文件都不纳入版本控制。

Claude Code

claude mcp add --transport http stockdrifts https://mcp.stockdrifts.io/mcp/ \
  --header "Authorization: Bearer sd_live_..."

或者将此代码库安装为插件（服务加技能）。Claude Code 会提示你输入一次密钥，并将其保存在系统的安全凭据存储中：

/plugin marketplace add Stockdrifts/stockdrifts-mcp
/plugin install stockdrifts@stockdrifts

Claude Desktop、Cursor 和其他 JSON 配置客户端

{
  "mcpServers": {
    "stockdrifts": {
      "type": "http",
      "url": "https://mcp.stockdrifts.io/mcp/",
      "headers": { "Authorization": "Bearer sd_live_..." }
    }
  }
}

Codex CLI

在 ~/.codex/config.toml 中（Codex 将此字段称为 http_headers）：

[mcp_servers.stockdrifts]
url = "https://mcp.stockdrifts.io/mcp/"
http_headers = { Authorization = "Bearer sd_live_..." }

一键安装程序

@stockdrifts/cli 包会为 Claude Code、Claude Desktop、Cursor 或 Codex 注册本地 stdio 服务，并将密钥存储在 ~/.stockdrifts/config.json（权限模式为 600）中，因此不会将密钥写入 Agent 自身的配置：

npx -y @stockdrifts/cli@latest install all --key sd_live_...
npx -y @stockdrifts/cli@latest doctor

提示词示例

• “哪些 5 星 13F 基金将 NVDA 列为主要持仓？各基金的平均买入价是多少？”
• “这只基金上个季度增持和减持了什么？”
• “显示过去 30 天中，金额超过 ₩1bn 的韩国公开市场内部人士买入记录。”
• “哪些预先披露的韩国内部人士买入计划尚未执行？”
• “哪些日本股票有多位投资者同时申报 5% 持股报告？”
• “提供此股票代码的 KPI 历史记录。”

工具

美国 13F 基金

工具	返回内容
search_investors_us	按名称模糊搜索投资者；解析为按 AUM 排序的 CIK
screen_investor_sector_exposure_us	按行业集中度筛选投资者（例如，生物科技领域的顶尖专业投资者）
screen_investor_catalyst_record_us	按基金在二元事件（任何行业）上的历史表现筛选
get_investor_holdings_us	某位投资者最新的 13F 持仓（或指定时期的持仓）
list_investor_periods_us	某位投资者存档的所有 13F 时期
get_investor_changes_us	某位投资者两个时期之间的环比持仓变化
get_investor_sector_exposure_us	某位投资者的行业敞口历史（最新季度优先）
get_investor_catalyst_record_us	单只基金按行业划分的二元事件历史表现，包含最佳和最差判断
list_ticker_holders_us	将 ticker 纳入前 50 大持仓的投资者，按持仓规模排序
screen_holdings_us	按时期、股票代码、价值和评级筛选 13F 持仓；对每只匹配的基金，仅返回匹配的持仓

公司 KPI

工具	返回内容
get_kpi	某个股票代码最新的标准化 KPI 快照

日本（EDINET 大额持股申报）

工具	返回内容
list_insider_filings_jp	某个 JP 股票代码的持股报告申报
get_insider_summary_jp	某个 JP 股票代码的预聚合持股摘要
list_recent_filings_jp	所有股票代码的近期 JP 申报
list_top_buys_jp	按时间段内汇总买入量排序的 JP 顶级股票代码
list_top_sells_jp	按时间段内汇总卖出量排序的 JP 顶级股票代码
list_investor_filings_jp	某位投资者（EDINET 代码）提交的所有 JP 申报
list_opportunities_jp	近期价格尚未大幅变动的 JP BUY/INITIAL 申报
list_leaderboard_jp	按星级和平均回报率排序的 JP 顶级投资者
list_convergence_jp	多位不同投资者就同一公司提交申报的 JP 股票代码
search_companies_jp	按 stock_code、日文名称或英文名称搜索 JP 公司

韩国（DART 内部人申报）

工具	返回内容
list_insider_trades_kr	某个 KR 股票代码的内部人交易
get_insider_summary_kr	某个 KR 股票代码的预聚合内部人摘要
list_recent_trades_kr	所有股票代码的近期 KR 内部人交易
list_top_buys_kr	按时间段内汇总的内部人买入量排序的 KR 顶级股票代码
list_top_sells_kr	按时间段内汇总的内部人卖出量排序的 KR 顶级股票代码
list_opportunities_kr	近期价格尚未大幅变动的 KR 公开市场买入交易
list_plans_kr	KR 预披露（D005）计划：已公告但尚未执行的交易
get_plan_executions_kr	将某项 D005 计划与其实际执行情况交叉参照
search_companies_kr	按 stock_code、韩文名称或英文名称搜索 KR 公司
list_leaderboard_kr	按买入交易的历史平均回报率排序的 KR 顶级内部人

跨市场筛选

工具	返回内容
screen_insiders	按国家、日期、价值、职位和股票代码筛选内部人活动

安全

• 仅在 Authorization 标头中发送密钥。不要将其放在 URL 中，以免出现在日志和 shell 历史记录中。
• MCP 服务不存储密钥。你的 bearer token 会转发至 api2.stockdrifts.io，由其执行身份验证、速率限制和使用限制。
• 所有工具均为只读。此服务不会写入数据、进行交易或更改账户状态。
• 未提供密钥时，服务会列出其工具，并对每次调用返回 unauthorized 错误。不会提供任何数据。
• 请访问 https://app.stockdrifts.io/settings/api-keys 轮换或撤销密钥。
• 请将安全问题报告至 [email protected]。

速率限制和错误

限制按密钥计算，以一分钟为窗口，响应中会包含 X-RateLimit-* 标头。错误采用统一格式：{"error": {"code", "message", "hint"}}。请参阅 API 参考。

数据说明

• 数值字段会在名称中标明货币（value_usd、value_krw、value_jpy）。不会进行任何隐式换算。
• 13F 报告期为季度末日期，例如 2026-06-30。省略报告期即可获取档案中最新的季度数据。
• 13F 文件按季度提交，并会在季度结束后最多 45 天内公布。
• 这些数据仅供研究使用，不构成投资建议。

许可证

本仓库中的文件采用 MIT 许可证。StockDrifts API 的访问权限及其返回的数据属于单独的付费服务，受 StockDrifts 的条款和隐私政策约束。