内容
# 工具列表
## 概述
90多种MCP工具，适用于Claude、ChatGPT和Cursor等AI代理：SEC文件、基本面数据、13F机构持仓、内幕交易和国会交易、财报电话会议记录、空头兴趣和宏观数据。免费托管层或自托管开源堆栈。
## 快速开始（托管，30秒）
1. 在 [equibles.com](https://equibles.com) 上创建免费账户 - 不需要信用卡。
2. 在 [`https://equibles.com/dashboard/apikeys`](https://equibles.com/dashboard/apikeys) 上创建API密钥。 它以 `eq_` 开头，只显示一次，所以请立即复制。
3. 使用URL `https://mcp.equibles.com/mcp` 连接您的客户端（见下文）。
ChatGPT 和 Claude（网页和桌面版）可以直接跳过密钥，通过OAuth登录。
## 连接您的AI客户端
### Claude 桌面版 / Claude 网页版 (claude.ai)
设置 → 连接器 → 添加自定义连接器 → URL `https://mcp.equibles.com/mcp` → 通过OAuth登录（无需密钥）。
密钥替代方法：使用URL `https://mcp.equibles.com/mcp?api_key=eq_your_api_key`。
### Claude 代码
```bash
claude mcp add --transport http equibles https://mcp.equibles.com/mcp
```
然后运行 `/mcp` 并选择 **Authenticate** 通过OAuth登录。
密钥替代方法：
```bash
claude mcp add-json equibles '{"type":"http","url":"https://mcp.equibles.com/mcp","headers":{"Authorization":"Bearer eq_your_api_key"}}' --scope user
```
### ChatGPT
添加开发者模式连接器，URL为 `https://mcp.equibles.com/mcp`，并完成OAuth登录（或使用 `?api_key=eq_your_api_key` URL）。
### Cursor
添加到 `~/.cursor/mcp.json`：
```json
{ "mcpServers": { "equibles": { "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }
```
### VS Code (Copilot)
```bash
code --add-mcp '{"name":"equibles","type":"http","url":"https://mcp.equibles.com/mcp"}'
```
或添加 `.vscode/mcp.json`，包含`"servers"`对象，使用相同的URL和`Authorization`头部形状：
```json
{ "servers": { "equibles": { "type": "http", "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }
```
### 任意MCP客户端
使用HTTP传输，URL为 `https://mcp.equibles.com/mcp`，通过`Authorization: Bearer eq_...`头部或`?api_key=eq_...`查询参数进行身份验证。
连接后，请在 [https://equibles.com/docs/mcp](https://equibles.com/docs/mcp) 上查看每个客户端的完整指南。
## 示例提示
- "哪些对冲基金在上季度购买了最多的英伟达？"
- "总结特斯拉最新10-K中的风险因素。"
- "显示微软最近的内幕销售情况，国会成员今年是否交易过该股票？"
- "英伟达对下一季度有何指导，报告了哪些KPI？"
- "哪些股票今天的空头挤压分数最高？"
- "筛选盈利的软件股票，市盈率低于20。"
- "最新的CPI和失业率是多少？"
## 工具
90多种工具，按数据集分组。
### SEC文件搜索和全文RAG
| 工具 | 描述 |
|---|---|
| SearchDocuments | 跨所有公司SEC文件的混合关键词+语义搜索。 |
| SearchCompanyDocuments | 按股票代码搜索一家公司的文件。 |
| SearchDocument | 在单个文件中进行混合搜索。 |
| ListCompanyDocuments | 浏览公司的可用SEC文件和记录。 |
| SearchDocumentKeyword | 在一个文件中进行关键词搜索。 |
| ReadDocumentLines | 读取文件中的一行范围。 |
### 财务报表和基本面（XBRL）
| 工具 | 描述 |
|---|---|
| GetFinancialStatement | 获取某一财政期间的损益表、资产负债表或现金流量表（XBRL）。 |
| GetFinancialFact | 获取一个财务概念随时间变化的数据。 |
| CompareFinancialFact | 比较不同公司之间的财务概念。 |
| GetRevenueBreakdown | 获取收入的细分情况，按部门、地区和产品（维度XBRL）。 |
### 13F机构持仓和对冲基金投资组合
| 工具 | 描述 |
|---|---|
| GetFundCloneBacktest | 回测克隆机构投资者的13F投资组合与市场基准。 |
| GetTopHolders | 获取股票的顶级机构持有者，来自SEC 13F-HR文件，按持股数量排名。 |
| GetOwnershipHistory | 获取机构所有权的历史趋势，跨季度。 |
| GetInstitutionPortfolio | 获取特定机构的13F-HR投资组合。 |
| SearchInstitutions | 按名称或SEC CIK搜索机构投资者。 |
| GetTopBuyersSellers | 获取股票中份额增加/减少最多的机构。 |
| GetMarketWide13FActivity | 获取市场范围内的13F排行榜（顶级买入/卖出/新建/卖出）。 |
| GetMostHeldStocks | 获取股票的机构13F广度排名。 |
| GetInstitutionSummary | 获取13F投资者的投资组合摘要（价值、集中度、换手率）。 |
| GetInstitutionSectorAllocation | 获取机构的13F行业配置。 |
| GetInstitutionQuarterlyActivity | 获取新进/增加/减少/退出活动 vs 前一季度。 |
| GetFundOverlap | 获取两个机构之间的13F投资组合重叠。 |
| GetConsensusHoldings | 获取2-25家机构的共识投资组合。 |
### 内幕交易（Form 3/4/5 & Form 144）
| 工具 | 描述 |
|---|---|
| GetInsiderTransactions | 获取最近的内幕交易，来自SEC Form 3/4/5。 |
| GetInsiderOwnership | 获取内幕所有权摘要，按持股数量排名。 |
| GetProposedSales | 获取拟议的内幕销售，来自SEC Form 144。 |
| SearchInsiders | 按姓名搜索公司内幕人员。 |
| GetInsiderSentimentScores | 获取股票的最高复合内幕情绪分数（0-100）。 |
### 国会股票交易
| 工具 | 描述 |
|---|---|
| GetCongressionalTrades | 获取股票的代码交易数据。 |
| GetMemberTrades | 获取成员披露的交易数据。 |
| GetMemberNetWorth | 获取成员的净资产历史数据，来自披露信息。 |
| SearchCongressMembers | 按姓名搜索国会成员。 |
| GetMarketWideCongressionalActivity | 获取国会交易最多的股票，跟踪时间窗口。 |
### 财报电话会议：记录、摘要和AI洞察
| 工具 | 描述 |
|---|---|
| GetEarningsCallEvent | 获取某一财政季度的财报电话会议事件。 |
| ListInvestorEvents | 获取最近的投资者活动。 |
| GetInvestorEventSpeakers | 获取事件ID的发言者标注记录。 |
| GetEarningsCallSpeakers | 获取财政季度财报电话会议的发言者标注记录。 |
| GetEarningsBrief | 获取AI财报摘要（TL;DR，牛/熊，引用）。 |
| GetCallInsights | 获取AI评分的洞察（语气，套期保值，主题）。 |
### 盈利指导、KPI和非GAAP桥梁
| 工具 | 描述 |
|---|---|
| GetGuidance | 从8-K和电话会议记录中获取盈利指导。 |
| GetCompanyKpis | 获取公司特定的KPI（订阅者，ARR，调整后EBITDA...）。 |
| GetNonGaapBridge | 获取非GAAP到GAAP的对账。 |
### 股票价格和技术指标
| 工具 | 描述 |
|---|---|
| GetStockPrices | 获取每日OHLCV历史（拆分调整）。 |
| GetLatestPrices | 获取最新收盘价、变化和成交量。 |
| GetStochasticOscillator | 获取随机震荡指标序列。 |
| GetAverageTrueRange | 获取平均真实范围（ATR）序列。 |
| GetOnBalanceVolume | 获取平衡量（OBV）序列。 |
| GetBollingerBands | 获取布林带序列。 |
### 空头兴趣、空头交易量和暗池（FINRA）
| 工具 | 描述 |
|---|---|
| GetShortVolume | 获取每日空头交易量（FINRA）。 |
| GetShortInterest | 获取双月空头兴趣。 |
| GetShortInterestSnapshot | 获取市场范围内的最新结算快照。 |
| GetLargestShortVolume | 获取最大的每日空头交易量。 |
| GetShortSqueezeScores | 获取最高的复合0-100空头挤压分数。 |
| GetOffExchangeVolume | 获取每周暗池/场外交易量（FINRA ATS）。 |
### 估值倍数和股票筛选
| 工具 | 描述 |
|---|---|
| GetValuationMultiples | 获取EV/收入、EV/EBIT、市盈率，并附行业四分位数。 |
| GetValuationMultiplesHistory | 获取相同的估值倍数随时间变化。 |
| ScreenStocks | 使用数据集范围筛选股票。 |
| GetCorrelatedStocks | 获取相关性最强和最弱的股票，按日回报率计算。 |
### 经济数据（FRED）和宏观日历
| 工具 | 描述 |
|---|---|
| GetEconomicIndicator | 获取FRED指标的时间序列（~40个精选系列）。 |
| GetLatestEconomicData | 获取类别下的最新值。 |
| SearchEconomicIndicators | 搜索精选系列。 |
| GetEconomicCalendar | 获取预定和最近的美国宏观经济发布。 |
### 期货仓位（CFTC COT）
| 工具 | 描述 |
|---|---|
| GetCftcPositioning | 获取期货合约的COT仓位。 |
| GetLatestCftcData | 获取最新的COT快照，涵盖~35个跟踪合约。 |
| SearchCftcMarkets | 搜索跟踪的CFTC合约。 |
### 波动性和期权情绪（CBOE）
| 工具 | 描述 |
|---|---|
| GetPutCallRatios | 获取CBOE的看跌/看涨比率（总/权益/指数/Vix/Etp）。 |
| GetVixHistory | 获取VIX每日OHLC历史。 |
### 基金、ETF和投资顾问
| 工具 | 描述 |
|---|---|
| SearchInvestmentAdvisers | 搜索SEC注册的投资顾问（Form ADV）。 |
| GetInvestmentAdviser | 获取CRD编号的完整Form ADV资料。 |
| GetFundOperations | 获取Form N-CEN的基金运营数据。 |
| GetFundHoldings | 获取最新NPORT-P的基金/ETF投资组合持仓。 |
| GetFundsHoldingStock | 获取持有特定股票的基金/ETF。 |
| GetExemptOfferings | 获取Form D的私人配售。 |
| GetFailsToDeliver | 获取SEC半月文件的FTD数据。 |
| SearchFunds | 搜索注册的基金/ETF。 |
| GetFundProfile | 获取NPORT-P的基金资料和最大持仓。 |
### 公司事件和治理
| 工具 | 描述 |
|---|---|
| GetExecutiveChanges | 获取8-K项目5.02的执行官/董事变更。 |
| GetExecutiveCompensation | 获取DEF 14A的薪酬。 |
| GetBuybackPrograms | 获取股票回购计划和历史。 |
| GetAtmPrograms | 获取现价股权发行计划。 |
| GetGoingConcernStatus | 获取最新文件的持续经营疑虑状态。 |
| GetCustomerConcentration | 获取客户集中度风险披露。 |
| GetInvestorRelationsNews | 获取最近的投资者关系新闻稿。 |
| GetInvestorRelationsEvents | 获取即将到来的投资者关系活动/网络直播。 |
| GetSuperInvestors | 获取精选超级投资者目录，附13F CIK。 |
| GetGovernmentContracts | 获取公司赢得的联邦合同（USAspending.gov）。 |
| GetTopGovernmentContractors | 获取联邦合同金额排名靠前的公司。 |
| GetFdaCatalysts | 获取预定的FDA咨询委员会会议。 |
| GetMarketStatus | 获取美国市场交易状态。 |
| GetMarketCalendar | 获取市场假日和半日交易。 |
## 定价和速率限制
| 计划 | 每日请求 | 价格 | 需要信用卡 |
|---|---|---|---|
| 免费 | 100 请求/天 | $0 | 否 |
| 专业 | 10,000 请求/天 | 见[定价](https://equibles.com/pricing) | 是 |
- 在MCP服务器和REST API之间共享每日计数器；它在00:00 UTC重置。
- 速率限制头部在响应中公开：`X-RateLimit-Limit`、`X-RateLimit-Remaining`、`X-RateLimit-Reset`和`Retry-After`（429时）。
- 当您超过限制时，MCP服务器会用一个正常的工具结果解释限制，而不是返回不透明的错误，因此您的代理可以读取并对其做出反应。
详见 [https://equibles.com/pricing](https://equibles.com/pricing)。
## 使用Docker自托管（开源）
完整堆栈开源于 [https://github.com/daniel3303/Equibles](https://github.com/daniel3303/Equibles)。
```bash
git clone https://github.com/daniel3303/Equibles
cd Equibles
docker compose up
```
MCP服务器在 `http://localhost:8081/mcp` 上启动。 默认情况下，不需要API密钥；设置 `MCP_API_KEY` 环境变量需要 `Authorization: Bearer <key>` 头部。 自托管时，Bearer头部是唯一的身份验证方法（无查询参数，无OAuth）。
自托管服务器公开62工具开源子集：13F持仓、内幕交易、SEC文件和基本面、基金/ETF/顾问、FRED、CFTC、CBOE、国会交易、空头数据、股票价格和FDA日历。 托管服务器在其上添加商业层：财报电话会议、指导、KPI、筛选器、估值倍数、回购、执行官数据等。
注意：自托管堆栈针对主要来源运行自己的爬虫，因此数据库从空开始，启动后随时间填充。
## REST API
所有内容也作为传统REST API在 `https://api.equibles.com/v1` 上提供，与MCP服务器共享相同的API密钥和每日限制。 文档见 [https://equibles.com/docs](https://equibles.com/docs)。
## 数据源和方法
每个数据集都从主要来源解析，而不是从第三方估计：
- **SEC EDGAR** — 文件、XBRL基本面、13F持仓、Form 3/4/5/144、NPORT、ADV、N-CEN、Form D
- **FINRA** — 空头交易量、空头兴趣、暗池/场外交易量
- **FRED** — 经济指标和宏观系列
- **CFTC** — 交易者承诺期货仓位
- **CBOE** — 看跌/看涨比率和VIX
- **USAspending.gov** — 联邦政府合同奖励
- **公司IR网站** — 投资者关系新闻和活动
- **国会披露** — 成员交易和净资产
方法论详情见 [https://equibles.com/docs/methodology](https://equibles.com/docs/methodology)。
## 链接
- 网站： [https://equibles.com](https://equibles.com)
- 文档： [https://equibles.com/docs](https://equibles.com/docs)
- 创建API密钥： [https://equibles.com/dashboard/apikeys](https://equibles.com/dashboard/apikeys)
- 开源堆栈： [https://github.com/daniel3303/Equibles](https://github.com/daniel3303/Equibles)
- 定价： [https://equibles.com/pricing](https://equibles.com/pricing)
