findscripter 何时使用
当需要把一家上市公司的评级与关键指标拉成时间序列、看其随时间的变化轨迹时使用：一次调用按 Ticker 返回最多 N 条历史记录，每条含综合评分（1–5）、字母评级（A+ 至 F）以及 ROA/ROE/DCF/D-E 四项 1–5 分指标，适合：
- 趋势分析：判断财务健康是在改善还是恶化，识别长期保持高分的稳健标的。
- 升降级监控：跟踪持仓的评级变化，捕捉 A+→B 这类突变拐点作为预警。
- 拐点与背离定位：发现单项指标（ROA/ROE）的拐头，或 ROE 高而 ROA 低这类杠杆驱动的背离。
- 同业轨迹对比：横向比较竞品的评级走势，看谁在变好。
不该用的边界：
- 只要当期快照 / 单点初筛 / 多标的横向打分排序 —— 那是另一条，用
octagon-ratings-snapshot（含 P/E、P/B 六项指标）。 - 需破产风险 / 财务强度评分（Z-Score、Piotroski）—— 用
octagon-financial-health-scores。 - 要逐项自建模型、复算每个评分或做敏感性分析 —— 转
dcf-valuation-model/three-statement-model。 - 离线 / 未配置 Octagon MCP 的环境 —— 本条依赖
octagon-agent工具，无 MCP 无法取数。 - 评级是辅助信号，不替代完整尽调与人工复核。
步骤
- 确认 MCP 就绪：环境已配置 Octagon MCP，
octagon-agent工具可见（Windows 需先装 Node.js / npx；配置见下「指令」）。 - 确定分析参数：标的 Ticker（如
NVDA）+ 历史记录条数上限 N（如 100 / 500 / 2000 / 5000，越大覆盖区间越长）。 - 发起查询：调用
octagon-agent，prompt 点名要 historical financial ratings 与 key metric scores，并用limited to <N> records控量。 - 读取时间序列：按日期排列的综合评分 / 字母评级 + ROA/ROE/DCF/D-E 四项分。
- 做趋势解读（不是看单期）：连续高分=稳定优秀；单项上行=运营效率改善；评级突降=触发深挖；ROE 高 + ROA 低=可能靠杠杆撑回报；D/E 分稳定或上行=杠杆管理稳健。
- （可选）追加深挖：评级方法论、与历史均值对比、同业轨迹对比。
指令
Octagon MCP 配置（Claude Desktop / Windsurf，claude_desktop_config.json）：
{
"mcpServers": {
"octagon-mcp-server": {
"command": "npx",
"args": ["-y", "octagon-mcp@latest"],
"env": { "OCTAGON_API_KEY": "YOUR_API_KEY_HERE" }
}
}
}
API Key 在 https://app.octagonai.co 注册后于 API Keys 菜单生成。Windows 命令行临时启动可用 cmd /c "set OCTAGON_API_KEY=<key> && npx -y octagon-mcp"。
MCP 调用：
{
"server": "octagon-mcp",
"toolName": "octagon-agent",
"arguments": {
"prompt": "Retrieve historical financial ratings and key metric scores over time for NVDA, limited to 2000 records."
}
}
查询模板： Retrieve historical financial ratings and key metric scores over time for <TICKER>, limited to <N> records.
数据源：octagon-financials-agent。
关键指标含义（分值越高越优）：
| 指标 | 衡量什么 | 分区 |
|---|---|---|
| 综合评分 Overall Score | 综合财务健康 | 1–5（5 最佳） |
| 字母评级 Overall Rating | 财务健康字母等级 | A+ 至 F |
| ROA 分 | 总资产收益率（资产效率） | 1–5（5 最佳） |
| ROE 分 | 净资产收益率（盈利能力） | 1–5（5 最佳） |
| DCF 分 | 折现现金流估值 | 1–5（5 最佳） |
| D/E 分 | 负债权益比（杠杆健康度） | 1–5（5 = 杠杆最低/最稳健） |
示例
查询 NVDA（limited to 2000 records）的典型返回（按日期倒序的时间序列）：
| 日期 | 综合评分 | 字母评级 | ROA | ROE | DCF | D/E |
|---|---|---|---|---|---|---|
| 2024-01-15 | 5 | A+ | 4 | 4 | 3 | 3 |
| 2024-01-08 | 5 | A+ | 4 | 4 | 3 | 3 |
| 2023-12-29 | 5 | A | 4 | 3 | 3 | 3 |
| … | … | … | … | … | … | … |
解读：综合评分长期维持 5 分、评级在 A/A+ 间小幅波动 → 稳定的财务优秀者；2023-12-29 → 2024-01-08 ROE 由 3 升 4，提示盈利能力改善。
变体查询：
- 近期聚焦：
...for AAPL, limited to 100 records. - 超长历史：
...for MSFT, limited to 5000 records.
追问深挖（按需）：
- "What ratings criteria drive these historical scores?"
- "How do NVDA's recent ratings compare to its historical averages?"
- "Compare the rating trajectories of and over time."
注意事项
- 看趋势而非单点：本条的价值在时间序列，下结论要看走势与拐点，单条记录意义有限。
- 方向需对齐：D/E「高分 = 低杠杆 = 更好」，别把原始负债数值当评分；所有评分已统一为越高越优。
- 同业归一化：跨行业（银行 vs 软件）评级不可直比；轨迹对比应在同业内做。
- records 控量：
limited to <N>决定覆盖时间跨度与返回体量；N 过大易冗长或超时，按需取 100/500/2000。 - 降级即信号：综合评级突降（如 A+→B）应触发对财报的深入调查，而非直接淘汰。
- API Key 安全：Key 经
OCTAGON_API_KEY环境变量注入，勿硬编码；遇限流降低查询频率。 - 结果定位：评级是监控 / 预警信号，不替代完整尽调、建模与专家复核。
互见
- requires：（无）
- related：
octagon-ratings-snapshot（当期评级快照与多标的初筛，本条是其历史时序版）、octagon-financial-health-scores（破产风险 / 财务强度评分，互补维度）、octagon-price-target-consensus（分析师目标价共识）、alpha-vantage-market-data（拉取行情与基本面原始数据）。 - combines_with：
octagon-financial-growth-metrics（增长指标历史趋势，与评级轨迹联读看「质量+成长」）、portfolio-risk-metrics（对持仓评级走势配合组合层风险监控）、octagon-equity-research-analyst（评级拐点触发后做深度股票研究）。
本条采编自 OctagonAI/skills（MIT 许可），已做中文适配重写。