signaldaemon

signaldaemon

面向 AI Agent 的叙事与信号情报——加密货币、AI 和宏观领域。 一条简单但值得信赖的管道：它传递经过筛选的叙事与信号，而非原始数据， 并且安全失败——没有覆盖时会如实说明，而不是编造。 专为机器而非人眼打造。

• API + MCP：https://api.signaldaemon.com
• 文档：https://signaldaemon.com/api
• 自助获取密钥：POST /v1/request-key（无需注册）

此仓库是入口——包含快速入门、客户端配置和接口契约。管道本身（来源、评分、筛选）并非开源。

---

它是什么（以及不是什么）

它是什么	它不是什么
跨来源的叙事趋同 + 资金与叙事的背离	价格／市场数据 API（这类数据请使用 CoinGecko 等服务）
覆盖约 14 个加密货币／AI／宏观领域	原始新闻源源不断的推送
安全失败——宁可“没有覆盖”，也不产生幻觉	可供查询事实的数据库
面向 Agent（API／MCP），不受 Token 成本限制，质量优先	面向用户的仪表板

快速入门

# 1 · self-serve a demo key (no signup)
KEY=$(curl -s -X POST https://api.signaldaemon.com/v1/request-key | jq -r .key)

# 2 · the day's ranked narratives + derived signals (cached, instant)
curl -s https://api.signaldaemon.com/v1/narratives \
  -H "x-api-key: $KEY" -d '{"limit":8}'

# 3 · clean narrative feed for a topic
curl -s https://api.signaldaemon.com/v1/feed \
  -H "x-api-key: $KEY" -d '{"query":"restaking","limit":8}'

从你的 Agent 连接（MCP）

通过 Streamable HTTP 使用远程 MCP，并通过 x-api-key 请求头进行身份验证。

# Claude Code
claude mcp add --transport http signaldaemon \
  https://api.signaldaemon.com/mcp --header "x-api-key: <KEY>"

# Hermes Agent — ~/.hermes/config.yaml
mcp_servers:
  signaldaemon:
    url: "https://api.signaldaemon.com/mcp"
    headers: { x-api-key: "<KEY>" }

更多客户端（Cursor、Cline）配置见 examples/mcp-configs.md。 工具：get_market_narratives(limit) · get_clean_feed(query, category, limit) · vet_trade(symbol, side)——均标注为 readOnlyHint。vet_trade 是交易前置关卡：向它提供一笔候选交易，它会返回基于叙事层的立场 （support／caution／contradict／no_signal），以及理由和置信度——它负责审核， 而非提供建议。

本地 stdio 桥接器

对于不支持远程 MCP 的客户端，此仓库提供一个轻量级 stdio 桥接器（mcp_server.py），通过托管 API 提供相同的三个工具。它不包含任何方法论——只是一个客户端。

pip install mcp
export SIGNALDAEMON_API_KEY=cns_...   # https://signaldaemon.com/console
python mcp_server.py

也可以使用 Docker：

docker build -t signaldaemon-mcp . && \
docker run -i -e SIGNALDAEMON_API_KEY=cns_... signaldaemon-mcp

桥接器无需密钥即可启动并响应自省请求（tools/list）； 调用工具则需要密钥。

接口

端点和响应字段契约（包括 divergence 架构）见 API.md。字段名称保持稳定。

许可证

此仓库中的示例和文档采用 MIT 许可证（参见 LICENSE）。 signaldaemon 服务和管道为专有。