Coin News OpenClaw Skill

Coin News OpenClaw

Collect cryptocurrency news from configurable sources, normalize the articles, score relevance, and return a structured digest that can be tuned over time.

Use This Skill When

The user wants a daily or on-demand crypto news digest
The user wants news for a specific token or narrative
The user wants to replace or compare against an existing Dify news workflow
The user wants a configurable pipeline that PA can tune later

Workflow

Read references/sources.yaml to determine enabled sources and source weights.
Read references/scoring.yaml to determine token aliases, topic keywords, negative keywords, and ranking logic.
If deterministic collection is needed, run scripts/fetch_coin_news.py.
Filter the normalized article list to the user’s requested scope.
Rank articles using source weight, keyword matches, recency, and duplicate suppression.
Return a short digest or a structured JSON array for downstream workflow use.

CLI Usage

# Basic usage - JSON output (default)
python3 scripts/fetch_coin_news.py --days 1

# ⭐ Markdown output with clickable links (recommended for reading)
python3 scripts/fetch_coin_news.py --days 1 --format markdown

# Limit number of articles
python3 scripts/fetch_coin_news.py --days 1 --limit 10 --format markdown

# Filter by specific tokens
python3 scripts/fetch_coin_news.py --days 1 --token BTC --token ETH

# Filter by specific topics
python3 scripts/fetch_coin_news.py --days 1 --topic etf --topic regulation

# Adjust token fetch limit (default: 100, max: 250)
python3 scripts/fetch_coin_news.py --days 1 --token-limit 50

# Disable dynamic token fetching (use only YAML config)
python3 scripts/fetch_coin_news.py --days 1 --no-dynamic-tokens

Output Formats

JSON (default)

python3 scripts/fetch_coin_news.py --days 1

Returns structured JSON for programmatic use.

Markdown (recommended for reading)

python3 scripts/fetch_coin_news.py --days 1 --format markdown

Returns formatted markdown with clickable links for each article:

## 1. [Article Title](https://example.com/article)
**来源**: CoinDesk | **时间**: 2026-03-25 | **分数**: 78
**Token**: BTC, ETH
**主题**: etf

Summary text here...
---

Time Range

Default: last 24 hours
Support explicit day windows such as:
- recent 2 days
- recent 3 days
- recent 7 days
Support common Chinese requests such as:
- 最近2天
- 最近3天
- 最近一周
- 过去7天
For deterministic runs, prefer --days <n> over manually converting to hours.
If both --days and --hours are provided, --days takes precedence.
Recommended mapping:
- 最近2天 -> --days 2
- 最近3天 -> --days 3
- 最近一周 -> --days 7
- 过去7天 -> --days 7

Dynamic Token Fetching

The skill automatically fetches the top 100 tokens (by market cap) from CoinGecko API and merges them with the YAML config:

Source: CoinGecko API (free, no API key required)
Cache TTL: 24 hours (stored in scoring.yaml under dynamic_tokens)
Merge logic: YAML token_aliases overrides dynamic tokens (for manual tuning)
Disable: Use --no-dynamic-tokens to use only YAML config

Output Contract

Prefer this JSON structure for workflow handoff:

[
  {
    “title”: “Example headline”,
    “url”: “https://example.com/article”,
    “source”: “CoinDesk”,
    “published_at”: “2026-03-20T09:00:00Z”,
    “summary”: “One paragraph summary.”,
    “score”: 78,
    “matched_topics”: [“bitcoin”, “etf”],
    “matched_tokens”: [“BTC”],
    “duplicate_group_key”: “normalized-title-key”
  }
]

Tuning Rules

Do not hardcode source lists in prompts. Update references/sources.yaml.
Do not hardcode scoring logic in prompts. Update references/scoring.yaml.
Prefer established publications before secondary aggregators.
If the user asks for “latest” or “today”, prioritize the last 24 hours and show exact dates.

References

references/sources.yaml: source registry and weights
references/scoring.yaml: token aliases, topic keywords, penalties, thresholds
scripts/fetch_coin_news.py: deterministic RSS collector and scorer

Agent Skills: Coin News OpenClaw

Install this agent skill to your local

Skill Files