init

knowledge/guide.md

@@ -0,0 +1,47 @@
+# OpenNews MCP Server — Usage Guide
+
+## Overview
+
+This MCP server provides access to crypto news from the 6551 news platform
+via REST API and WebSocket. It replaces direct database access with API calls.
+
+## Available Tools
+
+### Discovery
+- **get_news_sources**: Get all available news source categories (Bloomberg, Reuters, etc.)
+- **list_news_types**: Flat list of news type codes for filtering
+
+### News Search
+- **get_latest_news**: Get most recent news (no filters)
+- **search_news**: Search by keyword
+- **search_news_by_coin**: Search by coin symbol (BTC, ETH, SOL, etc.)
+- **get_news_by_source**: Filter by source (Bloomberg, Reuters, Coindesk, etc.)
+- **get_news_by_engine**: Filter by engine type (news, listing, onchain, meme, market)
+- **search_news_by_date**: Search within a date range
+
+### AI Ratings
+- **get_high_score_news**: Get articles with high AI scores (>=70)
+- **get_news_by_signal**: Filter by trading signal (long/short/neutral)
+
+### Real-time
+- **subscribe_latest_news**: Connect to WebSocket for live news updates
+
+## Workflow Examples
+
+1. **Quick market overview**: `get_latest_news(limit=10)`
+2. **Coin-specific research**: `search_news_by_coin(coin="BTC", limit=20)`
+3. **Source-specific feed**: `get_news_by_source(source="Bloomberg")`
+4. **Bullish signals**: `get_news_by_signal(signal="long")`
+5. **High-impact news**: `get_high_score_news(min_score=80)`
+
+## Data Structure
+
+Each news article contains:
+- `id`: Unique article ID
+- `text`: Article headline/content
+- `newsType`: Source type (Bloomberg, Reuters, etc.)
+- `engineType`: Engine category (news, listing, onchain, etc.)
+- `link`: URL to original article
+- `coins`: Array of related coins with symbol, market_type, match
+- `aiRating`: AI analysis with score, grade, signal, summary, enSummary
+- `ts`: Timestamp of the article