analyzing-market-sentiment

Analyzing Market Sentiment 是一个用于分析加密货币市场情绪的技能，通过组合多个数据源给出综合性的市场情绪判断。

【用途】 该技能用于衡量加密货币市场的整体情绪氛围，既可分析整体市场，也可针对特定币种（如 BTC、ETH 等）进行分析。适用于判断市场情绪状态、检查市场是否处于极端情绪区间，以及为交易模型提供情绪数据输入等场景。

【主要能力】

1. 综合情绪评分：给出 0-100 的综合情绪评分及对应分类。
2. 多数据源组合：
   • 恐惧与贪婪指数（Fear & Greed Index）：来自 Alternative.me 的市场整体情绪。
   • 新闻情绪（News Sentiment）：基于关键词对近期加密新闻进行分析。
   • 市场动量（Market Momentum）：来自 CoinGecko 的价格与成交量趋势。
3. 币种特定分析：可提取指定币种符号进行针对性分析。
4. 情绪组成拆解：提供情绪各组成部分的详细拆解（detailed 模式）。
5. 多输出格式：支持表格（table）、JSON、CSV 格式，并可将结果输出到文件。
6. 自定义权重：可通过 --weights 自定义新闻、恐惧与贪婪、动量三部分的权重，例如 "news:0.5,fng:0.3,momentum:0.2"。

【使用方式】 使用前需满足以下前提条件：

• 安装 Python 3.8+。
• 具备 requests 库：pip install requests。
• 具备访问 API 的网络连接（Alternative.me、CoinGecko）。
• 可选：crypto-news-aggregator 技能以增强新闻分析。

运行脚本的基本命令：

• 快速情绪检查（默认）：python {baseDir}/scripts/sentiment_analyzer.py
• 指定币种：python {baseDir}/scripts/sentiment_analyzer.py --coin BTC
• 详细分析：python {baseDir}/scripts/sentiment_analyzer.py --detailed
• 导出 JSON：python {baseDir}/scripts/sentiment_analyzer.py --format json --output sentiment.json
• 自定义时间周期：python {baseDir}/scripts/sentiment_analyzer.py --period 7d --detailed
• 自定义权重（偏重新闻）：python {baseDir}/scripts/sentiment_analyzer.py --weights "news:0.5,fng:0.3,momentum:0.2"

命令行选项：

• --coin：分析指定币种（BTC、ETH 等），默认全市场。
• --period：时间周期（1h、4h、24h、7d），默认 24h。
• --detailed：显示完整组件拆解，默认 false。
• --format：输出格式（table、json、csv），默认 table。
• --output：输出文件路径，默认 stdout。
• --weights：自定义权重，默认使用内置权重。
• --verbose：启用详细输出，默认 false。

使用流程建议：先评估用户意图（整体市场或特定币种、快速或详细），再执行对应命令，最后格式化呈现结果：显示综合评分与分类、解释情绪含义、突出极端读数；详细模式下展示组件拆解。

【情绪分类标准】

• 0-20：极度恐惧（市场恐慌，潜在底部）。
• 21-40：恐惧（情绪谨慎，偏空）。
• 41-60：中性（均衡，无明显偏向）。
• 61-80：贪婪（乐观，偏多情绪）。
• 81-100：极度贪婪（狂热，潜在顶部）。

【输出示例说明】 表格格式默认输出综合评分、分类及组件拆解（恐惧与贪婪指数、新闻情绪、市场动量各自的分数、权重和贡献值），并附带解读文本。JSON 格式输出 composite_score、classification、components（含各组件明细）以及 meta（时间戳、周期）信息。

【错误处理】

• 恐惧与贪婪指数不可用（API 宕机）：使用带警告的缓存值。
• 新闻获取失败（网络问题）：降低新闻组件权重。
• 无效币种（未知符号）：继续执行全市场分析。 更详细的错误处理参见 {baseDir}/references/errors.md，示例参见 {baseDir}/references/examples.md，配置选项参见 {baseDir}/config/settings.yaml。

【限制与说明】 该技能依赖外部 API（Alternative.me、CoinGecko）的可用性与网络连接。情绪分析理论将极端读数视为反向指标，极端读数往往先于反转出现。具体收费、价格等信息暂未提供。