antitone — 中文财经情报 CLI + Skill：A 股 / 港股 / 美股新闻情报、行业题材热度、早晚报、A股基本面

技能简介

antitone 是为中文金融场景打造的 CLI + Skill 双形态财经情报工具，覆盖 A 股 / 港股 / 美股的新闻情报、行业题材热度、早午晚报、财经日历与 A 股公司基本面（单季 / TTM / 估值 / 可比对比）。命令行适合开发者直查，Skill 形态专为 AI Agent 设计 —— 装入技能目录后 Agent 会根据上下文自动判断何时调用，无需用户在提问中点名触发。所有 13 个工具均为只读，单次返回硬截断 32 KB，每次响应都附带 billing（消耗 + 余额 + 今日免费额度）让 Agent 自行控费。1.12.0 起按合规要求不再提供行情类数据（实时报价 / K 线 / 涨停池等需证券交易所许可）。

核心能力

• 多市场新闻检索：按关键词 / 股票代码 / 题材 / 时间窗搜索 A 股 / 港股 / 美股新闻，可叠加情绪过滤（--sentiment neg），单次最多拉取 200 条
• 消息面全景：market（行业热度 + 题材 + 头条）、sectors（行业情报热度）、themes（活跃题材总览）聚合当日异动
• 早午晚报：briefing --type premarket|midday|postmarket 提供 AI 纪要式简报，15 积分 / 份
• 财经日历：calendar 拉取数据 / 财报 / 解禁 / 会议事件，可按市场、板块、个股筛选
• 公司档案：entity 拉取单标的档案及可选财务摘要，fundamentals 提供 12 期累计 / 单季 / TTM / 估值 / 收入构成 / 解禁
• 多公司可比：compare_fundamentals 支持 ≤30 家同口径对比 TTM / 增速 / 毛利率 / ROE / PE / PS / PB / 主营
• 可执行工作流：recipe premarket / intraday / weekly / stock / risks 把上述工具串成开箱即用的剧本
• Skill 自触发：装入 Agent 技能目录后无需点名调用，Agent 根据上下文自动判断

安装配置

# 1. 设置密钥
export ANTITONE_API_KEY=nhk_xxx.yyy

# 2. 装入 Agent 技能目录（自动识别 ~/.agents、~/.claude、~/.codex）
npx -y antitone@latest skill --install

# 3. 自检
npx -y antitone doctor

环境变量 ANTITONE_API_KEY（必填）、ANTITONE_BASE_URL（默认 https://api.antione.cc:8443，8443 端口不可省）、ANTITONE_TIMEOUT_MS（默认 20000，早晚报可调至 60000）、ANTITONE_MAX_BYTES（默认 32768）。Node.js ≥ 18.17。

使用步骤

1. 安装并重启 Agent（Claude Code / Codex / Cursor / Kimi / Trae / Gemini CLI 等）
2. 用自然语言向 Agent 提问，如「今天半导体有什么利空？」「宁德时代最新基本面」
3. Agent 自动触发 antitone 工具链拉取数据
4. 查看返回结果并追问深入（全文 / 单条新闻 / 历史跨度数据）
5. 用 balance 命令监控余额，按预算调整调用频率
6. 用 recipe premarket / intraday / weekly 跑开箱即用的剧本

适用场景

• 个股研究：拉新闻 + 公司档案 + 基本面 + 可比公司对比，覆盖单标的深度分析
• 行业研究：题材热度排行 + 行业新闻聚合，捕捉板块轮动信号
• 盘中决策：早午晚报 + 行业热度，捕捉板块异动与突发消息
• 风险排查：recipe risks 自动跑风控剧本，输出风险事件清单
• 事件回测：拉历史跨度数据（>7 天积分 ×2，>180 天 ×5）做事件驱动策略
• 跨市场对照：同时拉 A 股 + 港股 + 美股新闻做产业链对照

适用人群

• 金融研究员 / 投资经理：跨市场财经情报聚合，减少手工检索
• AI Agent 开发者：让 Claude Code / Codex / Cursor 等 Agent 自动接入金融数据
• 个人投资者：用 Skill 形态让 Agent 主动跟踪持仓的新闻与基本面
• 量化分析师：取财经事件 / 新闻数据用于策略回测与信号构建
• 财经内容创作者：快速产出市场日报 / 周报素材

工作原理

CLI 走 Authorization: Bearer 鉴权，所有请求直连 api.antione.cc:8443（8443 端口为合规接入端口，不可省略）。Skill 包内嵌 Agent 上下文触发描述，Agent 解析用户意图后通过工具调用协议自动选择合适工具。每次工具调用返回结构化 JSON：ok / tool / as_of / stale / truncated / billing 字段，Agent 可据此判断是否继续追问。所有 13 个工具标注 readOnlyHint: true，compare_fundamentals 即便走 POST 也是幂等的只读查询。

官方链接

• npm 包：https://www.npmjs.com/package/antitone
• 官网控制台：https://antione.cc（注：CLI / Skill 中域名 antione.cc 系历史选择，非笔误）
• GitHub：https://github.com/xiazhi88/antione
• API 基址：https://api.antione.cc:8443
• 1.12.0 起已停供行情类数据（合规要求）