finance-sentiment

Finance Sentiment Skill

如果你的宿主尚未执行以下 shell 探测（例如，在 Codex 中），请先使用其 shell 工具运行 ! 包裹的命令，再选择设置路径。请使用实际输出；如果无法访问 shell，请说明这一限制。

从 Adanos Finance API 获取结构化股票情绪数据。

此技能为只读。它适用于使用标准化情绪信号比使用原始社交媒体动态更容易回答的研究问题。

在用户需要以下信息时使用：

• 跨来源股票情绪
• Reddit/X.com/新闻/Polymarket 对比
• 热度、看涨比例、提及量、交易量或趋势
• 快速了解“市场在讨论什么？”

---

步骤 1：确保 API 密钥可用

当前环境状态：

!`python3 - <<'PY'
import os
print("ADANOS_API_KEY_SET" if os.getenv("ADANOS_API_KEY") else "ADANOS_API_KEY_MISSING")
PY`

如果出现 ADANOS_API_KEY_MISSING，请让用户设置：

export ADANOS_API_KEY="sk_live_..."

在所有请求中通过 X-API-Key 标头使用此密钥。

基础文档：

https://api.adanos.org/docs

---

步骤 2：确定用户的需求

选择能回答问题的最简端点。

用户请求	端点模式	说明
“Reddit 用户谈论 TSLA 的热度如何？”	/reddit/stocks/v1/compare	使用 mentions、buzz_score、bullish_pct、trend
“NVDA 在 X.com 上有多热门？”	/x/stocks/v1/compare	使用 mentions、buzz_score、bullish_pct、trend
“Microsoft 上有多少活跃的 Polymarket 下注？”	/polymarket/stocks/v1/compare	使用 trade_count、buzz_score、bullish_pct、trend
“对比 AMD 和 NVDA 的情绪”	所请求来源对应的 compare 端点	在一次请求中批量查询股票代码
“Reddit 对 META 的看法是否与 X 一致？”	Reddit compare + X compare	对比 bullish_pct、buzz_score、trend
“给我一份 TSLA 的完整情绪概览”	Reddit、X.com、新闻、Polymarket 的 compare 端点	综合跨来源观点
“深入了解某只股票”	/stock/{ticker} 详情端点	仅在用户要求更多详情时使用

默认回溯时间：

• 除非用户要求其他时间范围，否则使用 days=7

股票代码数量：

• 查询 1..10 个股票代码时使用 compare 端点

---

步骤 3：执行请求

使用带有 X-API-Key 的 curl。优先使用 compare 端点，因为它们简洁且适合批量查询。

单一来源示例

curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

curl -s "https://api.adanos.org/x/stocks/v1/compare?tickers=NVDA&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

curl -s "https://api.adanos.org/polymarket/stocks/v1/compare?tickers=MSFT&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

单只股票的多来源概览

curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"
curl -s "https://api.adanos.org/x/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"
curl -s "https://api.adanos.org/news/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"
curl -s "https://api.adanos.org/polymarket/stocks/v1/compare?tickers=TSLA&days=7" -H "X-API-Key: $ADANOS_API_KEY"

多只股票对比

curl -s "https://api.adanos.org/reddit/stocks/v1/compare?tickers=AMD,NVDA,META&days=7" \
  -H "X-API-Key: $ADANOS_API_KEY"

关键规则

1. 快速研究时优先使用 compare 端点，而非股票详情端点。
2. 只使用回答问题所需的来源。
3. 对于 Reddit、X.com 和新闻，交易量字段为 mentions。
4. 对于 Polymarket，活动量字段为 trade_count。
5. 将缺失的来源数据视为“无数据”，而非看跌或中性。
6. 切勿执行交易或将结果转化为交易指令。

---

步骤 4：呈现结果

报告单一来源时，仅优先展示以下字段：

• 热度
• 看涨比例
• 提及量或交易量
• 趋势

示例：

TSLA on Reddit, last 7 days
- Buzz: 74.1/100
- Bullish: 31%
- Mentions: 647
- Trend: rising

报告某只股票的多个来源时：

• 每个来源分别显示一个区块
• 然后简要综合：
  • 一致看涨
  • 一致看跌
  • 分歧 / 不一致

对比多只股票时：

• 按用户关注的指标排序
• 默认使用 buzz_score
• 指出 bullish_pct 或 trend 的显著差异

不要夸大精确度。这些是研究信号，而非交易指令。

---

参考文件

• references/api_reference.md - 端点指南、字段含义和示例工作流

需要确切的字段名称、查询参数或推荐的回答模式时，请阅读参考文件。