From cf722fcb25645a4e6deed54d28a299f206bf572f Mon Sep 17 00:00:00 2001 From: beare <945412026@qq.com> Date: Mon, 30 Mar 2026 12:44:05 +0800 Subject: [PATCH] chore(docs): update version number to 1.0.3 and restructure free tools documentation - Incremented version number in SKILL.md from 1.0.2 to 1.0.3. - Restructured the documentation for free tools, consolidating information and providing clearer examples for accessing free news categories and hot news by category. - Added a new section for free API endpoints, detailing usage and response structures. --- openclaw-skill/opennews/SKILL.md | 211 +++++++++++++------------------ 1 file changed, 90 insertions(+), 121 deletions(-) diff --git a/openclaw-skill/opennews/SKILL.md b/openclaw-skill/opennews/SKILL.md index ac5dce7..5711858 100644 --- a/openclaw-skill/opennews/SKILL.md +++ b/openclaw-skill/opennews/SKILL.md @@ -21,7 +21,7 @@ metadata: - darwin - linux - win32 - version: 1.0.2 + version: 1.0.3 --- # OpenNews Crypto News Skill @@ -42,86 +42,6 @@ Real-time crypto & financial news aggregator powered by 6551.io — **72+ data s | **Meme** | 1 | Twitter meme coin social sentiment | | **Market** | 6 | Price Change, Funding Rate, Funding Rate Difference, Large Liquidation, Market Trends, OI Change | -## Free Tools (No Token Required) - -Two tools are available **without** an API token: - -### 1. Get News Categories - -Get all available news categories and subcategories. - -```bash -curl -s "https://ai.6551.io/open/free_categories" -``` - -### 2. Get Hot News - -Get hot news articles and trending tweets by category. - -```bash -curl -s "https://ai.6551.io/open/free_hot?category=macro" -``` - -| Parameter | Type | Required | Description | -|-----------|------|----------|-------------| -| category | string | Yes | Category key from free_categories (e.g., `macro`, `crypto`, `defi`) | -| subcategory | string | No | Subcategory key for filtered results | - -**Example categories:** -- `macro` - Macro economics and policy -- `crypto` - Cryptocurrency news -- `blockchain` - Blockchain technology -- `defi` - DeFi updates -- `nft` - NFT news -- `market` - Market analysis - -**Response structure:** -```json -{ - "success": true, - "category": "crypto", - "subcategory": "defi", - "news": { - "success": true, - "count": 10, - "items": [ - { - "id": 123, - "title": "DeFi Protocol Reaches $1B TVL", - "source": "CoinDesk", - "link": "https://...", - "score": 85, - "grade": "A", - "signal": "bullish", - "summary_zh": "...", - "summary_en": "...", - "coins": ["BTC", "ETH"], - "published_at": "2026-03-17T10:00:00Z" - } - ] - }, - "tweets": { - "success": true, - "count": 5, - "items": [ - { - "author": "Vitalik Buterin", - "handle": "VitalikButerin", - "content": "...", - "url": "https://...", - "metrics": { "likes": 1000, "retweets": 200, "replies": 50 }, - "posted_at": "2026-03-17T09:00:00Z", - "relevance": "high" - } - ] - } -} -``` - -### Get API Token for Full Access - -To access all 72+ sources with AI analysis, trading signals, and real-time WebSocket updates, get your API token at https://6551.io/mcp - ## Authentication All requests require the header: @@ -231,26 +151,7 @@ Important: You need to understand the user's query intent and perform word segme ## Common Workflows -### Free Tools (No Token Required) - -**Get all categories:** -```bash -curl -s "https://ai.6551.io/open/free_categories" -``` - -**Get hot crypto news:** -```bash -curl -s "https://ai.6551.io/open/free_hot?category=macro" -``` - -**Get DeFi subcategory news:** -```bash -curl -s "https://ai.6551.io/open/free_hot?category=macro&subcategory=defi" -``` - -### Premium Tools (Requires API Token) - -**Quick Market Overview:** +### Quick Market Overview ```bash curl -s -X POST "https://ai.6551.io/open/news_search" \ -H "Authorization: Bearer $OPENNEWS_TOKEN" \ @@ -266,26 +167,94 @@ curl -s -X POST "https://ai.6551.io/open/news_search" \ -d '{"limit": 50, "page": 1}' | jq '[.data[] | select(.aiRating.score >= 80)]' ``` +--- + +## Free API Endpoints (No Token Required) + +If you don't have an `OPENNEWS_TOKEN`, you can use these free endpoints as a fallback. These provide curated hot news and trending tweets by category, but with limited search capabilities compared to the authenticated API. + +### 1. Get Free News Categories + +Get all available news categories and subcategories for the free tier. + +```bash +curl -s -X GET "https://ai.6551.io/open/free_categories" +``` + +### 2. Get Hot News by Category + +Get hot news articles and trending tweets by category. No authentication required. + +```bash +curl -s -X GET "https://ai.6551.io/open/free_hot?category=macro" +``` + +**Parameters:** + +| Parameter | Type | Required | Description | +|-----------|------|----------|-------------| +| `category` | string | yes | Category key from free_categories | +| `subcategory` | string | no | Subcategory key for more specific filtering | + +**Response Structure:** +```json +{ + "success": true, + "category": "crypto", + "subcategory": "defi", + "news": { + "success": true, + "count": 10, + "items": [ + { + "id": 123, + "title": "...", + "source": "...", + "link": "https://...", + "score": 85, + "grade": "A", + "signal": "bullish", + "summary_zh": "...", + "summary_en": "...", + "coins": ["BTC", "ETH"], + "published_at": "2026-03-17T10:00:00Z" + } + ] + }, + "tweets": { + "success": true, + "count": 5, + "items": [ + { + "author": "Vitalik Buterin", + "handle": "VitalikButerin", + "content": "...", + "url": "https://...", + "metrics": { "likes": 1000, "retweets": 200, "replies": 50 }, + "posted_at": "2026-03-17T09:00:00Z", + "relevance": "high" + } + ] + } +} +``` + +**Example - Get Hot Crypto News:** +```bash +curl -s -X GET "https://ai.6551.io/open/free_hot?category=macro" +``` + +**Example - Get DeFi Subcategory News:** +```bash +curl -s -X GET "https://ai.6551.io/open/free_hot?category=macro&subcategory=defi" +``` + +--- + ## Notes -### Free vs. Premium Features - -**Free (no token required):** -- `get_news_categories` - Browse available news categories -- `get_hot_news` - Get hot news by category - -**Premium (requires API token from https://6551.io/mcp):** -- Full access to 72+ data sources -- AI analysis with impact scores (0-100), grades (A-F), and trading signals (long/short/neutral) -- Advanced search by keyword, coin, source, or engine type -- Real-time WebSocket news streaming -- Bilingual summaries (English & Chinese) -- Market anomaly signals (liquidations, funding rates, OI changes) - -### API Limits - -- Rate limits apply; max 100 results per request +- **Primary API**: Get your token at https://6551.io/mcp for full access to 72+ sources with advanced search +- **Free API**: Use free endpoints as fallback when token is unavailable (limited to curated hot news) +- Rate limits apply; max 100 results per request for authenticated API - AI ratings may not be available on all articles (check `status == "done"`) -- **Free API data is cached and updated periodically** - not real-time -- If data is still being generated, a 503 response may be returned -- Get your API token at https://6551.io/mcp for full access +- Free API data is cached and updated periodically; if data is still being generated, a 503 response will be returned