coinintel

coinintel

coinintel 封装了一个只读的加密市场情报 API： 用于查找和解析币种、获取当前价格和历史数据、 单个币种的情绪、风险和信号、全市场健康状况、 情绪和市场状态读数、趋势和币种扫描、叙事、 类别，以及资金费率动向和提醒。一个二进制文件同时提供 命令行界面和 stdio MCP 服务。

使用时需要 API 密钥。请先设置 SHUMI_TOKEN；如果该值 缺失或为空，所有工具都会报错并指出 SHUMI_TOKEN，且不会发出任何请求。密钥通过 x-api-key 请求头发送。可通过 SHUMI_API_URL 覆盖 API 基础 URL；若未设置，调用将发送至 https://api.shumi.ai（这是重建版本——上游 README 未公开基础 URL）。

返回列表的工具遵循同一约定：top（整数） 仅保留前 N 项，fields（以逗号分隔的 名称列表）仅保留每项中指定的字段。两者都会 发送给 API，并且也会在本地对数组响应执行相同的裁剪。

此构建是一个带标签的核心子集：包含 20 个只读工具。上游工具集还记录了信号质量、交易对 建议、现实世界资产、解锁、持有者、钱包、期货、 篮子、文字稿、问答和网页搜索工具； 这些工具不属于此子集。

安装

npx @reneturcios/coinintel get_regime

也可以运行容器镜像：

docker run -i ghcr.io/cloudcorprecords/coinintel

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

子命令与 MCP 工具名称一致：

export SHUMI_TOKEN=...

coinintel lookup_coin --query bitcoin
coinintel resolve_coin --query ether
coinintel get_prices --symbols BTC,ETH --top 2 --fields symbol,price
coinintel get_coin_historical --coin BTC --range 30d
coinintel get_coin_sentiment --coin BTC
coinintel get_coin_risk --coin BTC
coinintel get_global_market
coinintel get_market_health --top 5
coinintel scan_trends
coinintel scan_coins --fields symbol,score
coinintel list_narratives
coinintel get_narrative --narrative "ai tokens"
coinintel list_categories
coinintel get_category --category defi
coinintel get_funding_momentum
coinintel get_funding_alerts
coinintel get_regime
coinintel get_signal --coin BTC

coinintel --version

结果会打印上游 JSON 载荷。退出码：成功时为 0， 调用失败时为 1（包括缺少令牌或上游 API 错误）， 用法错误时为 2。

MCP 服务

一个二进制文件提供两种使用方式。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/coinintel mcp

MCP 客户端配置：

{
  "mcpServers": {
    "coinintel": {
      "command": "npx",
      "args": ["-y", "@reneturcios/coinintel", "mcp"],
      "env": { "SHUMI_TOKEN": "..." }
    }
  }
}

工具

工具	输入	功能
lookup_coin	query（必填）	查找与自由文本查询匹配的币种。
resolve_coin	query（必填）	将查询解析为单个规范币种。
get_prices	symbols（必填数组）、top、fields	获取指定代码的当前价格。
get_coin_historical	coin（必填）、range、top、fields	获取某个币种的历史数据。
get_coin_sentiment	coin（必填）、top、fields	获取某个币种的情绪数据。
get_coin_risk	coin（必填）	获取某个币种的风险评估。
get_global_market	top、fields	获取全球市场概览数据。
get_market_health	top、fields	获取市场健康指标。
get_market_sentiment	top、fields	获取汇总市场情绪。
get_market_crossing	top、fields	获取市场交叉信号。
scan_trends	top、fields	扫描当前市场趋势。
scan_coins	top、fields	根据市场标准扫描币种。
list_narratives	top、fields	列出市场叙事。
get_narrative	narrative（必填）	获取单个市场叙事。
list_categories	top、fields	列出币种类别。
get_category	category（必填）	获取单个币种类别。
get_funding_momentum	top、fields	获取资金费率动向数据。
get_funding_alerts	top、fields	获取资金费率提醒。
get_regime	（无）	获取当前市场状态。
get_signal	coin（必填）	获取某个币种的交易信号。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

许可证

MIT — 参见 LICENSE。