alphasmo-tools

AlphaSMO — 面向 AI 的终极聪明资金 API

用于 AlphaSMO 的 CLI + MCP 服务 — SEC EDGAR 13F 机构持仓、Form 4 内部人交易，以及“聪明资金趋同”信号（对冲基金 和 公司内部人同时买入的股票代码）。你可以通过终端、脚本，或任何兼容 MCP 的 AI Agent（Claude、ChatGPT、Cursor 等）进行查询。

无需注册、无需 API 密钥、无需设置 — 现在就试试：

npx alphasmo stocks flows --limit 10

示例输出：

┌────────┬──────────────────────────────┬────────────────────┬──────────────┬──────────────┐
│ ticker │ issuer                       │ net flow (USD)     │ avg weight % │ institutions │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ BRK-A  │ BERKSHIRE HATHAWAY INC-CL A  │ 247,455,256,379    │ 1.42         │ 1418         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AZN    │ AstraZeneca PLC              │ 148,465,847,587.12 │ 0.47         │ 1309         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ XOM    │ EXXON MOBIL CORP             │ 138,784,059,363.77 │ 0.78         │ 4716         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CVX    │ CHEVRON CORP                 │ 77,783,933,645.44  │ 0.6          │ 4261         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ JNJ    │ JOHNSON & JOHNSON            │ 64,498,075,844.9   │ 0.76         │ 4603         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ SNDK   │ SANDISK CORP                 │ 58,662,972,096.01  │ 0.65         │ 1172         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ MU     │ MICRON TECHNOLOGY INC        │ 55,374,569,969.23  │ 0.7          │ 2993         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ AMAT   │ APPLIED MATERIALS INC        │ 48,790,109,328.41  │ 0.52         │ 2931         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ EEM    │ ISHARES MSCI EMERGING MARKET │ 48,211,222,155.7   │ 0.59         │ 1637         │
├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤
│ CAT    │ CATERPILLAR INC              │ 46,035,710,179.58  │ 0.5          │ 3724         │
└────────┴──────────────────────────────┴────────────────────┴──────────────┴──────────────┘

为什么选择 AlphaSMO

• 📊 13F 机构持仓 — 每家对冲基金和资产管理公司的 SEC 季度申报：资产管理规模、持仓以及行为“特征评分”（集中度、换手率、行业信心）。阅读我们的指南：什么是 13F 申报？ 和如何解读机构持仓变化。
• 🕵️ 内部人交易（Form 4 和 144） — 高管、董事和持股 10% 以上的所有者的买入与卖出记录，并为每个股票代码提供信心评分。了解更多：什么是 Form 4 申报？ 和什么是 Form 144 申报？。
• 🚀 聪明资金趋同 — 核心信号：13F 机构 和 公司内部人当前同时买入的股票代码。
• 🤖 为 AI Agent 打造 — 开箱即用的 MCP 服务，让 Claude、ChatGPT、Cursor 或任何 MCP 客户端都能在对话中获取真实金融数据。
• 🆓 免费匿名使用层 — 无需注册即可试用；随时获取免费 API 密钥，提高速率限制。

使用场景

"What is smart money buying right now?"        → alphasmo convergence
"What does Berkshire Hathaway hold?"            → alphasmo institutions holdings berkshire-hathaway-inc
"Are insiders buying or selling NVDA?"          → alphasmo insider summary NVDA
"Which stocks are institutions dumping?"        → alphasmo stocks flows --direction sell

将 MCP 服务接入 Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端（见下文），然后用自然语言提问 — 无需编写代码。

CLI

npx alphasmo institutions search "Berkshire"
npx alphasmo stocks get AAPL
npx alphasmo convergence -l 5

无需安装 — npx 会自动获取并运行。也可以全局安装：

npm install -g alphasmo
alphasmo --help

命令

命令	返回内容
alphasmo institutions search <query> [-l|--limit]	按名称搜索 13F 机构
alphasmo institutions list [-l|--limit] [-o|--offset]	分页浏览全部机构（不使用查询条件）
alphasmo institutions get <slug>	机构详情，包括行业权重
alphasmo institutions holdings <slug>	某机构最新的 13F 持仓
alphasmo stocks get <identifier>	股票详情，包括持有人数量、资金流和主要持有人（identifier = 股票代码或 CUSIP）
alphasmo stocks flows [-d|--direction buy|sell] [-l|--limit]	按机构净买入／卖出资金流排名的股票
alphasmo insider trades <ticker>	某股票近期个人 Form 4 内部人士交易
alphasmo insider summary <ticker>	某股票的内部人士信心评分（30 天／90 天）
alphasmo convergence [-l|--limit] [--min-confidence] [--days]	13F 机构和内部人士同时买入的股票代码——旗舰信号
alphasmo mcp	通过 stdio 启动 MCP 服务

所有命令都支持的全局标志：--api-key <key>（环境变量 ALPHASMO_API_KEY）、--base-url <url>（环境变量 ALPHASMO_BASE_URL）、-f/--format json|compact|table|csv、--json（--format json 的简写）、--csv（--format csv 的简写）。

输出格式会根据使用场景自动检测——常见情况下无需指定标志：

• 直接在终端中输入命令 → 输出易读的表格，数字会添加千位分隔符（263,095,703,570）。
• 通过管道传递、重定向，或由脚本／AI Agent 启动（stdout 不是 TTY）→ 输出 JSON，可安全地传递给 jq 或提供给 Agent。
• 无论哪种情况，--format/--json/--csv 始终会覆盖自动检测结果。

alphasmo stocks flows --csv > flows.csv
alphasmo insider trades AAPL --csv | column -s, -t

错误会输出到 stderr，并使用不同的退出码（2 未找到、3 身份验证失败、4 达到速率限制、5 响应格式异常、1 其他错误），以便脚本无需匹配字符串即可分支处理。

获取 API 密钥

匿名请求会按 IP 限制速率。注册并在 alphasmo.com/developer 获取免费密钥，然后：

alphasmo convergence --api-key ask_live_...
# or
export ALPHASMO_API_KEY=ask_live_...

MCP 服务

选项 1：claude mcp add（推荐）

如果你使用 Claude Code，只需运行一条命令即可注册服务：

claude mcp add alphasmo -- npx -y alphasmo@latest mcp

在 -- 前添加 -e ALPHASMO_API_KEY=ask_live_... 可提高速率限制。运行 claude mcp list 确认已连接。

选项 2：手动配置 MCP 客户端

对于 Claude Desktop、Cursor 或其他 MCP 客户端，可将以下内容直接添加到配置文件中：

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": ["alphasmo", "mcp"],
      "env": { "ALPHASMO_API_KEY": "optional-your-key-here" }
    }
  }
}

这两种选项开箱即支持匿名使用，但速率限制低于使用密钥时的限制。公开的工具包括：search_institutions、get_institution_profile、get_institution_holdings、get_stock_overview、get_stock_flows、get_insider_activity、get_smart_money_convergence。

完整的端点参考：alphasmo.com/developer/docs。

编程使用

import { AlphasmoClient } from "alphasmo";

const client = new AlphasmoClient(); // no apiKey needed to try it
console.log(await client.getSmartMoneyConvergence({ limit: 5 }));

npm install alphasmo

另有 Python 客户端和 MCP 服务可供使用——设置说明请参阅 alphasmo.com/developer。

了解更多

• alphasmo.com — 完整的 Web 应用：机构档案、股票筛选器、内部人士交易排行榜
• alphasmo.com/developer — 获取免费 API 密钥
• alphasmo.com/developer/docs — 完整的公共 API 参考

教育指南与 SEC 文件深度解析

深入了解机构持仓和 SEC 文件动态：

• 什么是 13F 文件？ — 机构持仓披露入门指南。
• 什么是 Form 4 文件？ — 了解内部人士如何申报买入和卖出。
• 什么是 Form 144 文件？ — 了解内部人士抛售前向 SEC 提交的预售通知。
• 13D 与 13G 受益所有权 — 深入了解 5% 持股申报和激进投资者的意图。
• 如何解读机构持仓变动 — 解读 13F 投资组合变动，避免被股票拆分或期权机制误导。

许可证

MIT