news-aggregator-skill

# News Aggregator Skill

Fetch real-time hot news from multiple sources.

## Tools

### fetch_news.py

**Usage:**

```bash
### Single Source (Limit 10)
```bash
### Global Scan (Option 12) - **Broad Fetch Strategy**
> **NOTE**: This strategy is specifically for the "Global Scan" scenario where we want to catch all trends.

```bash
#  1. Fetch broadly (Massive pool for Semantic Filtering)
python3 scripts/fetch_news.py --source all --limit 15 --deep

# 2. SEMANTIC FILTERING:
# Agent manually filters the broad list (approx 120 items) for user's topics.
```

### Single Source & Combinations (Smart Keyword Expansion)
**CRITICAL**: You MUST automatically expand the user's simple keywords to cover the entire domain field.
*   User: "AI" -> Agent uses: `--keyword "AI,LLM,GPT,Claude,Generative,Machine Learning,RAG,Agent"`
*   User: "Android" -> Agent uses: `--keyword "Android,Kotlin,Google,Mobile,App"`
*   User: "Finance" -> Agent uses: `--keyword "Finance,Stock,Market,Economy,Crypto,Gold"`

```bash
# Example: User asked for "AI news from HN" (Note the expanded keywords)
python3 scripts/fetch_news.py --source hackernews --limit 20 --keyword "AI,LLM,GPT,DeepSeek,Agent" --deep
```

### Specific Keyword Search
Only use `--keyword` for very specific, unique terms (e.g., "DeepSeek", "OpenAI").
```bash
python3 scripts/fetch_news.py --source all --limit 10 --keyword "DeepSeek" --deep
```

**Arguments:**

- `--source`: One of `hackernews`, `weibo`, `github`, `36kr`, `producthunt`, `v2ex`, `tencent`, `wallstreetcn`, `all`.
- `--limit`: Max items per source (default 10).
- `--keyword`: Comma-separated filters (e.g. "AI,GPT").
- `--deep`: **[NEW]** Enable deep fetching. Downloads and extracts the main text content of the articles.

**Output:**
JSON array. If `--deep` is used, items will contain a `content` field associated with the article text.

## Interactive Menu

When the user says **"news-aggregator-skill 如意如意"** (or similar "menu/help" triggers):
1.  **READ** the content of `t...

# News Aggregator Skill

全网科技/金融新闻聚合助手，支持AI 智能解读。

## ✨ 功能特性

- **多源聚合**：一站式覆盖硅谷科技、中国创投、开源社区及金融市场。
- **深度阅读**：支持 Deep Fetch 模式，自动获取正文并进行 AI 深度分析。
- **智能周报**：自动生成杂志级排版的中文日报/周报。
- **交互菜单**：可通过"news-aggregator-skill 如意如意"唤醒交互式菜单，指哪打哪。

## 📚 聚合信源

覆盖全球 8 大主流高价值信息渠道：

- **全球科技**：Hacker News, Product Hunt
- **开源社区**：GitHub Trending, V2EX
- **中国创投**：36Kr, 腾讯新闻科技频道
- **社会/金融**：微博热搜, 华尔街见闻

## 📥 安装指南

### 第一步：安装到 Code Agent

选择以下任一方式将 Skill 添加到您的 Agent：

#### 方法 A：使用 Openskills CLI (推荐)

会自动处理路径依赖和配置同步。

```bash
# 克隆仓库
git clone git@github.com:cclank/news-aggregator-skill.git

# 安装 skill
openskills install ./news-aggregator-skill

# 同步配置到 Agent
openskills sync
```

#### 方法 B：使用 NPX (推荐 2)

直接从远程仓库添加。

```bash
npx skills add https://github.com/cclank/news-aggregator-skill
```

#### 方法 C：Claude 标准安装 (手动)

手动将 Skill 集成到 Claude 项目的标准方式。

```bash
# 1. 克隆仓库
git clone git@github.com:cclank/news-aggregator-skill.git

# 2. 定位或创建项目的 skills 目录
mkdir -p YourProject/.claude/skills

# 3. 将整个文件夹复制过去
cp -r news-aggregator-skill YourProject/.claude/skills/

# 4. 验证：确保 SKILL.md 存在于目标目录
ls YourProject/.claude/skills/news-aggregator-skill/SKILL.md
```

### 第二步：安装 Python 依赖（如果你的agent足够聪明，可以跳过）

进入已安装的 Skill 目录，执行依赖安装：

```bash
# 进入 Skill 安装目录 (根据您选择的安装方式调整路径)
cd ~/.claude/skills/news-aggregator-skill  # 或 YourProject/.claude/skills/news-aggregator-skill

# 安装依赖
pip install -r requirements.txt
```

## 🚀 如何使用

### 1. 🔮 唤醒交互菜单 (推荐)

最简单的使用方式，来自岚叔的彩蛋--直接召唤智能菜单：

> **"news-aggregator-skill 如意如意"**

系统将为您展示功能列表（如：早安日报、硅谷热点、全网扫描等），回复数字即可执行。

###...