openfigi

openfigi-mcp

OpenFIGI API 的 MCP（Model Context Protocol）服务。可直接在 Claude 和其他兼容 MCP 的 AI 助手中将金融标识符映射为 FIGI。

功能

• 按标识符类型搜索：ISIN、CUSIP、SEDOL、Ticker、Bloomberg ID
• 自动检测：自动从文本/CSV 数据中检测标识符类型
• Ticker + 交易所：解析 AAPL US、ABLI SS、VOD LN 等格式
• 批量操作：单次请求最多处理 100 个标识符
• 未找到报告：清楚标示不存在的标识符
• 参考资源：访问标识符类型、交易所代码和证券类型

安装

使用 npx（最简单）

无需安装——只需配置 Claude Desktop：

{
  "mcpServers": {
    "openfigi": {
      "command": "npx",
      "args": ["openfigi-mcp@latest"],
      "env": {
        "OPENFIGI_API_KEY": "your-api-key-here"
      }
    }
  }
}

全局安装

npm install -g openfigi-mcp

{
  "mcpServers": {
    "openfigi": {
      "command": "openfigi-mcp",
      "env": {
        "OPENFIGI_API_KEY": "your-api-key-here"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

可用工具

搜索工具

工具	描述	示例
search_by_isin	按 ISIN 搜索	US0378331005（Apple）
search_by_cusip	按 CUSIP 搜索	037833100（Apple）
search_by_sedol	按 SEDOL 搜索	2046251（Apple）
search_by_ticker	按 ticker 搜索（智能搜索）	AAPL，交易所代码为 US
search_by_bloomberg_id	按 Bloomberg ID 搜索	BBG000B9XRY4

智能 Ticker 搜索

搜索时，search_by_ticker 工具会自动尝试多种证券类型，因此无需判断股票是普通股还是优先股：

# These all work automatically:
AAPL US    → Common Stock (Apple)
VOW3 GY    → Preference shares (Volkswagen preferred)
P911 GY    → Preference shares (Porsche)
RR. LN     → Common Stock (Rolls-Royce)
BA. LN     → Common Stock (BAE Systems)

如果需要搜索特定证券类型，可以使用可选参数 securityType2：

securityType2	描述
Common Stock	普通股
Preference	优先股
Depositary Receipt	ADR、GDR
ETP	ETF 和其他交易所交易产品

自动检测工具

工具	描述
search_auto_detect	自动检测标识符类型并搜索单个标识符
parse_identifiers	解析 CSV/文本并检测标识符类型（不调用 API）
batch_search_auto_detect	在一次请求中解析并搜索多个标识符

实用工具

工具	描述
batch_mapping	使用明确的类型映射最多 100 个标识符
validate_identifier	验证标识符格式，不进行搜索
get_rate_limit_status	检查当前 API 速率限制状态

自动检测示例

带交易所代码的 Ticker

这些工具可识别 Bloomberg Terminal 格式 TICKER EXCHANGE：

Ticker
ABLI SS
ABSO SS
AAPL US
VOD LN
7203 JP

常见交易所代码：

代码	交易所
US	美国
SS	斯德哥尔摩（Nasdaq Stockholm）
LN	伦敦
GY	德国（Xetra）
JP	日本
HK	香港
FP	法国（Euronext Paris）

混合标识符

这些工具会自动检测不同的标识符类型：

US0378331005      → ISIN [high confidence]
BBG000B9XRY4      → Bloomberg ID [high confidence]
AAPL US           → Ticker with exchange [high confidence]
037833100         → CUSIP [medium confidence]
2046251           → SEDOL [medium confidence]
AAPL              → Ticker [low confidence]

未找到时的处理

如果 OpenFIGI 中不存在相应标识符，输出会清楚标示：

单项搜索：

Detected type: TICKER (Exchange: SS) [high confidence]

⚠️ NOT FOUND: "BLABLABLA" on exchange SS returned no results.

No results found

批量搜索：

Detected 3 identifiers:
  - Ticker: 3

[1] TICKER: AAPL [US]
Result 1:
  FIGI: BBG000B9XRY4
  Name: APPLE INC
  ...

---

[2] TICKER: INVALID [SS] ⚠️ NOT FOUND
No results found

---

[3] TICKER: MSFT [US]
Result 1:
  FIGI: BBG000BPH459
  ...

---
Results: 2 found, 1 not found

⚠️ Not found:
  - INVALID [SS]

可用资源

通过 MCP 资源访问参考数据：

资源 URI	描述
openfigi://identifier-types	支持的标识符类型列表（ID_ISIN、ID_CUSIP 等）
openfigi://exchange-codes	常见交易所代码（US、SS、LN 等）
openfigi://security-types	证券类型值（Common Stock、ETF 等）
openfigi://market-sectors	市场板块值（Equity、Corp 等）

环境变量

变量	描述	必需
OPENFIGI_API_KEY	您的 OpenFIGI API 密钥	否（但建议设置）

API 密钥

在 openfigi.com/api 获取免费 API 密钥。

	不使用 API 密钥	使用 API 密钥
速率限制	25 req/min	250 req/min

许可证

MIT