irkumo

irkumo-mcp

irkumo 的 MCP 服务（irkumo 是一个 API，可按证券代码、公司名称、曾用名或品牌名称查询日本 3,821 家上市公司的投资者关系（IR）页面 URL 和业绩公告（kessan tanshin）列表 URL。前往 https://api.irkumo.com/account/login 免费注册，即可获得 50 个试用积分（无需银行卡）。将密钥设为 IRKUMO_API_KEY，然后运行 npx -y irkumo-mcp。

---

这是一个 MCP（Model Context Protocol）服务，可搜索并获取上市公司的 IR 页面和业绩公告 URL。可通过 stdio 供 Claude Desktop、Claude Code、Cursor 等 AI 助手使用。

概述

irkumo-mcp 是 irkumo API 的 MCP 封装，可提供经核实的 3,821 家上市公司的 IR 页面 URL 和公司属性。 调用各工具时，只需指定所需的列，即可消耗积分获取数据。

功能

• 根据公司名称、简称或品牌名称确定一家公司的代码（resolve_company）
• 搜索符合条件的公司候选列表（search_companies）
• 根据证券代码获取 IR 页面 URL 和属性（get_company）
• 获取月度更新等差异数据（list_changes）
• 查看积分余额和有效期（get_balance）
• 查看可用的列定义、单价和来源（list_fields）

要求

• Node.js 20 或更高版本
• irkumo API 密钥（可通过 https://api.irkumo.com/account/login 仅使用电子邮件地址免费注册，并获得 50 个试用积分（有效期为 30 天）。 打开链接后，请在账户页面创建密钥。无需绑定银行卡）

安装与启动

直接通过 npx 运行（软件包发布后）

npx irkumo-mcp

从本地构建运行

cd mcp
npm install
npm run build
node dist/index.js

环境变量

变量名	必填	默认值	说明
IRKUMO_API_KEY	是	无	irkumo API 密钥（以 ir_live_... 开头的字符串）。即使未设置也会启动，可使用工具列表和 list_fields；其他工具则会返回注册指引
IRKUMO_API_BASE	否	https://api.irkumo.com	irkumo API 的基础 URL。本地开发时可指定 http://127.0.0.1:8787 等地址
IRKUMO_SITE_URL	否	https://irkumo.com	网站的基础 URL。余额不足（402）时用于提供购买指引链接

客户端配置示例

1. Claude Desktop

在配置文件（claude_desktop_config.json）中添加以下内容。

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

{
  "mcpServers": {
    "irkumo": {
      "command": "npx",
      "args": ["-y", "irkumo-mcp"],
      "env": {
        "IRKUMO_API_KEY": "ir_live_your_api_key_here"
      }
    }
  }
}

使用本地构建时：

{
  "mcpServers": {
    "irkumo": {
      "command": "node",
      "args": ["/path/to/ir-url-api/mcp/dist/index.js"],
      "env": {
        "IRKUMO_API_KEY": "ir_live_your_api_key_here",
        "IRKUMO_API_BASE": "http://127.0.0.1:8787"
      }
    }
  }
}

2. Claude Code

在 Claude Code CLI 中运行以下命令进行添加。

claude mcp add irkumo npx -y irkumo-mcp --env IRKUMO_API_KEY=ir_live_your_api_key_here

3. Cursor

在 .cursor/mcp.json 中添加以下内容。

{
  "mcpServers": {
    "irkumo": {
      "command": "npx",
      "args": ["-y", "irkumo-mcp"],
      "env": {
        "IRKUMO_API_KEY": "ir_live_your_api_key_here"
      }
    }
  }
}

工具列表与积分消耗

回复末尾始终会附加一行 credits_charged: N / credits_remaining: M。 请求已拥有的列会额外消耗积分，因此请只请求所需的列。

工具名	参数	返回内容	积分消耗
resolve_company	q：搜索词（1~100 个字符）	匹配度最高的一家公司的 code、name 和 match（stage）	1（无结果时为 0）
search_companies	q：搜索词、limit：数量（默认 3，最多 5）、fields：属性列（默认 code,name）、筛选条件	候选列表	1（无结果时为 0）
get_company	code：证券代码（4 位/5 位）、fields：列名（逗号分隔，默认 ir_url）	一家公司的指定列数据	请求的列数（每列 1 个积分）
list_changes	since：起始时间（ISO 8601 或版本名称）、limit：数量（默认 50）、column：按列名筛选	变更行列表	返回的行数（每行 1 个积分）
get_balance	无	积分余额和各批次积分的有效期	0
list_fields	无	列列表、单价和来源信息	0

注意事项

• search_companies 的 fields 只能指定属性列（code、code4、name、name_current、kana、en、industry、fiscal_month、prefecture、city）。不能指定 URL 列（ir_url、tanshin_url）或别名（aliases）。
• 如需 URL 列，请先通过 resolve_company 或 search_companies 获取证券代码，然后使用 get_company 指定所需的列。

余额不足时的提示

积分余额不足时（HTTP 402），不会抛出异常（错误），而是返回如下购买页面提示信息。

残高不足です｡購入ページ: https://irkumo.com/pricing.html (残高 0)
credits_charged: 0 / credits_remaining: 0

可通过提示中的 URL 购买额外的积分包。

速率限制

API 对每个密钥设有每 10 秒 20 个请求的速率限制。 超过限制时（HTTP 429），会返回消息 请稍后再试。（超过速率限制）。 请稍等片刻后重试。