READMEmain
We couldn't render this README. Read it on GitHub
MCP Stock News API
这是一个用于获取股票市场新闻和信息的 MCP(Model-Controller-Provider)模块。它使用 Alpha Vantage API 来获取实时的股票新闻数据。
功能特点
- 获取实时股票新闻
- 支持按股票代码筛选新闻
- 支持按主题筛选新闻
- 新闻情感分析评分
- 支持自定义新闻数量限制
安装
npm install @steezy789/mcp-stock-news-api
使用方法
-
首先,你需要获取一个 Alpha Vantage API key(可以在 https://www.alphavantage.co/support/#api-key 免费获取)
-
基本使用示例:
import { getStockNews, getTopStockNews, defaultTopics } from '@steezy789/mcp-stock-news-api';
// 获取所有新闻
const news = await getStockNews({
apiKey: 'YOUR_API_KEY',
limit: 10
});
// 获取特定股票的新闻
const teslaNews = await getStockNews({
apiKey: 'YOUR_API_KEY',
tickers: ['TSLA'],
limit: 5
});
// 获取特定主题的新闻
const techNews = await getStockNews({
apiKey: 'YOUR_API_KEY',
topics: ['technology'],
limit: 5
});
// 获取按情感分析评分排序的新闻
const topNews = await getTopStockNews({
apiKey: 'YOUR_API_KEY',
limit: 10
});
可用的主题
以下是所有可用的新闻主题:
- earnings (财报)
- ipo (首次公开募股)
- mergers_and_acquisitions (并购)
- financial_markets (金融市场)
- economy_fiscal (财政经济)
- economy_monetary (货币经济)
- economy_macro (宏观经济)
- energy_transportation (能源交通)
- finance (金融)
- life_sciences (生命科学)
- manufacturing (制造业)
- real_estate (房地产)
- retail_wholesale (零售批发)
- technology (科技)
返回数据格式
interface StockNews {
title: string; // 新闻标题
url: string; // 新闻链接
time_published: string; // 发布时间
summary: string; // 新闻摘要
source: string; // 新闻来源
ticker_sentiment?: { // 股票情感分析
ticker: string; // 股票代码
relevance_score: string; // 相关性评分
ticker_sentiment_score: string; // 情感评分
}[];
}
注意事项
- Alpha Vantage API 的免费版本有调用频率限制,请注意控制请求频率
- 建议将 API key 存储在环境变量中,而不是直接写在代码里
- 新闻数据默认按时间倒序排列,使用 getTopStockNews 可以按情感评分排序
许可证
MIT
