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.
This commit is contained in:
beare
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user