mcpField
F
Free Crypto News

Free Crypto News

本地服务
github.com/nirholas金融数据3262 周前更新
代码仓库

关于 Free Crypto News

Free Crypto News 是一个免费的加密货币新闻 MCP 服务与 HTTP API，汇集 300 多个来源的新闻，并提供行情、情绪与巨鲸提醒等数据。无需 API key 即可调用，适合需要加密资讯数据的开发者与 AI Agent。项目同时提供可自托管的版本。

主要功能

  1. 01汇集 300 多个来源的实时新闻
  2. 02全文搜索与历史文章归档查询
  3. 03市场数据、情绪指标与巨鲸动态
  4. 04RSS、Atom、SSE 与 WebSocket 订阅
  5. 05无需 API key 的 HTTP 接口
  6. 06可本地运行的 stdio MCP 服务

适用场景

  1. 01为 AI Agent 提供加密货币新闻上下文
  2. 02构建新闻看板或嵌入式新闻组件
  3. 03按代币与日期检索历史新闻数据

MCP 相关

该项目提供托管的 Streamable-HTTP MCP 端点以及本地 stdio MCP 服务，向 MCP 客户端暴露 40 多个新闻、搜索、归档与市场数据工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

name: Free Crypto News API type: api category: cryptocurrency auth: none pricing: free endpoints: 450+ sources: 300+ llms_txt: https://cryptocurrency.cv/llms.txt openapi: https://cryptocurrency.cv/api/openapi.json mcp_server: https://cryptocurrency.cv/api/mcp (hosted) or npx -y @nirholas/free-crypto-news-mcp (local) license: source-available (all rights reserved), hosted API free to use

🌐 语言（42 种）： 英语 | 阿拉伯语 | 保加利亚语 | 孟加拉语 | 捷克语 | 丹麦语 | 德语 | 希腊语 | 西班牙语 | 波斯语 | 芬兰语 | 法语 | 希伯来语 | 印地语 | 克罗地亚语 | 匈牙利语 | 印度尼西亚语 | 意大利语 | 日语 | 韩语 | 马来语 | 荷兰语 | 挪威语 | 波兰语 | 葡萄牙语 | 罗马尼亚语 | 俄语 | 斯洛伐克语 | 斯洛文尼亚语 | 塞尔维亚语 | 瑞典语 | 斯瓦希里语 | 泰米尔语 | 泰卢固语 | 泰语 | 菲律宾语 | 土耳其语 | 乌克兰语 | 乌尔都语 | 越南语 | 简体中文 | 繁体中文 · 所有翻译

🆓 免费加密货币新闻 API

GitHub 星标 许可证：source-available 问题

最近提交 贡献者 npm MCP 服务 OpenAPI

快速开始 • 你将获得什么 • 端点 • MCP • 自托管 • 文档

免费加密货币新闻 API 演示

通过一次 HTTP 调用，即可获取来自 300 多个来源的实时加密货币新闻。无需 API 密钥，无需注册，也无需处理速率限制手续。现已上线：cryptocurrency.cv。

面向 AI Agent： curl https://cryptocurrency.cv/api/news • llms.txt • llms-full.txt • OpenAPI • MCP：https://cryptocurrency.cv/api/mcp • AGENTS.md • SKILLS.md

⭐ 如果它为你节省了时间，请为仓库点星。这有助于其他人发现它。

⚡ 快速开始

只需 30 秒，无需密钥。cURL 开箱即用：

# Latest headlines from every source
curl https://cryptocurrency.cv/api/news

# Only the last two hours
curl https://cryptocurrency.cv/api/breaking

# Full-text search
curl "https://cryptocurrency.cv/api/search?q=bitcoin%20etf"

# Filter by category, cap the result size
curl "https://cryptocurrency.cv/api/news?category=defi&limit=20"

# Ask a question, answered from today's news (AI)
curl "https://cryptocurrency.cv/api/ask?q=why%20is%20ETH%20up%20today"

每个端点都返回 JSON、支持 CORS，并可在浏览器、脚本或 Agent 工具调用中使用。响应结构如下：

{
  "articles": [
    {
      "title": "Bitcoin Hits New ATH",
      "link": "https://coindesk.com/...",
      "description": "Bitcoin surpassed...",
      "pubDate": "2026-01-02T12:00:00Z",
      "source": "CoinDesk",
      "timeAgo": "2h ago"
    }
  ],
  "totalCount": 150,
  "fetchedAt": "2026-01-02T14:30:00Z"
}

在代码中使用，先运行 npm install @nirholas/crypto-news：

import { CryptoNews } from '@nirholas/crypto-news';
const news = await new CryptoNews().getLatest(10);

Python、Go、PHP、Rust、Ruby、Swift、Kotlin、Java、C# 和 R 客户端以可直接复制的源码形式存放在 sdk/ 中；适用于机器人、Agent 和 12 种语言的可运行示例存放在 examples/ 中。

🎁 你将获得

能力详情
信息源21 个类别中的 300 多个 RSS 订阅源，以及 77 个国际媒体（KO、ZH、JA、ES 等），支持即时翻译。按可信度分级。详情
端点450 多个路由：新闻、搜索、类别、市场数据、DeFi、大户、监管、投资组合、交易信号和订阅源。目录
历史存档自 2017 年 9 月起收录 662,047 篇文章，可按日期、代码、情绪和全文搜索。存档
AI 端点摘要、情绪分析、事实核查、叙事分析、研究模式、基于存档的 RAG、每日简报。免费，由 Groq 提供支持。AI 文档
MCP 服务托管的 Streamable-HTTP 端点，以及本地 stdio 服务，提供 40 多个工具。见下文
订阅源和流式传输RSS 2.0、Atom、OPML、Server-Sent Events、WebSocket。实时功能
小组件可直接嵌入的 HTML/JS 新闻滚动条和轮播组件。widget/
Web 应用89 个页面：仪表板、投资组合、自选列表、提醒、图表，以及可安装的 PWA。页面
SDK 示例sdk/ 中的客户端、examples/ 中的示例、docs/sdks/ 中的指南
适用于 Agentllms.txt、OpenAPI 3.1、/.well-known/agent.json、/.well-known/ai-plugin.json，以及适用于高级路由的 x402 小额支付。AGENTS.md
对比
Free Crypto NewsCryptoPanic其他
价格🆓 免费$29-299/mo付费
API 密钥❌ 无需需要需要
速率限制不限*100-1000/day有限制
信息源300 多个英文源 + 77 个国际源1不定
历史数据📚 662,000 多篇文章（2017-2026）有限无
国际化🌏 KO、ZH、JA、ES + 翻译无无
自托管✅ Docker / Cloud Run / Vercel无无
PWA✅ 可安装无无
MCP✅ 托管 + 本地无无
SDK 示例12 种语言01-2
AI 功能30 多个 AI 端点（免费）无无

* 合理使用。请在你一侧缓存，并使用 User-Agent 标识客户端；滥用流量将受到限流。

🔌 端点

按领域分类的精简 API 概览。交互式浏览器位于 cryptocurrency.cv/developers，叙述式参考文档见 docs/API.md，完整的 450 多个路由目录见 docs/reference/endpoints.md。

领域端点备注
新闻/api/news、/api/breaking、/api/search?q=、/api/news?category=limit、source、page、category 参数
分类/api/bitcoin、/api/defi、/api/news?category=institutional21 个分类，详见目录
国际新闻/api/news/international?lang=ko、/api/news?translate=es77 家媒体，18 种翻译目标语言
AI/api/ask、/api/ai（summarize、sentiment、fact-check）、/api/ai/summarize、/api/ai/narratives、/api/ai/research、/api/ai/brief、/api/rag、/api/predictions通过 Groq 免费使用
情绪与社交/api/sentiment、/api/fear-greed、/api/trending、/api/social无需密钥即可获取 X/Twitter 情绪
市场数据/api/market、/api/prices、/api/defi、/api/gas、/api/yields、/api/hyperliquid价格、DeFi、Gas、衍生品
链上数据/api/whales、/api/whale-alerts、/api/flows、/api/liquidations、/api/unlocks巨鲸预警、交易所资金流、解锁日历
投资组合与信号/api/portfolio、/api/signals、/api/alerts基于投资组合的新闻、交易信号
归档/api/archive?date=2024-01、?ticker=BTC、?q=、?stats=true662k 篇文章，详见归档
订阅源/api/rss、/api/atom、/api/opml、/api/sse、WebSocket流式传输与内容联合发布
元数据/api/sources、/api/health、/api/openapi.json、/api/stats来源列表、运行时间、规范
高级版（x402）/api/premium/*、/.well-known/x402使用 USDC 按次付费，无需账户。x402 文档
x402 一致性/api/x402/conformance根据 API 实际返回的挑战，审计任意 x402 API 的发现契约。文档、页面
版本化/api/v1/*上述所有接口的稳定别名
AI 端点示例

AI 路由同样无需密钥。它们通过托管的 Groq 集成运行：

# Natural-language question over today's news
curl "https://cryptocurrency.cv/api/ask?q=what%20happened%20with%20the%20SEC%20this%20week"

# One-paragraph summary of the current feed
curl "https://cryptocurrency.cv/api/ai/summarize"

# Emerging narratives, ranked by momentum
curl "https://cryptocurrency.cv/api/ai/narratives?emerging=true"

# Daily brief for a given date
curl "https://cryptocurrency.cv/api/ai/brief?date=2026-08-26&format=summary"

# Retrieval-augmented answer over the 662k-article archive
curl "https://cryptocurrency.cv/api/rag?q=bitcoin%20etf%20approval%20timeline"
历史归档

662,047 篇文章（涵盖自 2017 年 9 月起的 CryptoPanic 英文内容以及 Odaily 中文内容），并附有代币代码、命名实体、情绪，以及采集时的 BTC/ETH 价格和恐惧与贪婪指数读数。

curl "https://cryptocurrency.cv/api/archive?date=2024-01"                 # one month
curl "https://cryptocurrency.cv/api/archive?ticker=BTC&limit=100"          # by ticker
curl "https://cryptocurrency.cv/api/archive?q=bitcoin%20etf"               # full text
curl "https://cryptocurrency.cv/api/archive?start_date=2025-01-01&end_date=2025-01-07"
curl "https://cryptocurrency.cv/api/archive?stats=true"                    # counts and coverage

架构、目录布局和所有查询参数：docs/reference/archive.md。

🔮 MCP 服务

通过 Claude Desktop、Claude Code、Cursor 或任何 Model Context Protocol 客户端使用完整 API。提供 40 多种工具（新闻、搜索、归档、情绪、市场数据、投资组合）；完整工具列表见 mcp/README.md。

托管端点，无需安装。 Streamable-HTTP 服务运行于 https://cryptocurrency.cv/api/mcp：

{
  "mcpServers": {
    "crypto-news": {
      "url": "https://cryptocurrency.cv/api/mcp"
    }
  }
}

Claude Code，一行命令即可：

claude mcp add --transport http crypto-news https://cryptocurrency.cv/api/mcp

本地 stdio 服务。 在你的计算机上使用相同的工具，已发布为 @nirholas/free-crypto-news-mcp（源代码位于 mcp/）：

{
  "mcpServers": {
    "crypto-news": {
      "command": "npx",
      "args": ["-y", "@nirholas/free-crypto-news-mcp"]
    }
  }
}

或者从检出目录运行：git clone https://github.com/nirholas/cryptocurrency.cv.git && cd cryptocurrency.cv/mcp && npm install && node index.js。

其他 Agent 接入方式：ChatGPT 自定义 GPT 和 OpenAI 插件清单（/.well-known/ai-plugin.json）、Google A2A Agent 卡片（/.well-known/agent.json）、examples/agents/ 中的 LangChain 和 CrewAI 示例，以及 docs/reference/integrations.md 中可直接复制粘贴的 Discord、Telegram、Slack 和 LangChain 集成。

🧩 小组件

只需一个脚本标签，即可在任意页面中嵌入实时新闻动态。源码和示例位于 widget/。

<div id="crypto-ticker" data-limit="20" data-category="all" data-theme="dark"></div>
<script src="https://cryptocurrency.cv/widget/ticker.js"></script>

ticker.js 滚动显示头条，carousel.js 渲染卡片，embed.js 将完整新闻动态嵌入容器。三者都会读取 data-* 属性来设置数量上限、类别、速度和主题。

🐳 自托管

所有内容都运行在一个 Next.js 应用中。所有环境变量均为可选；不设置任何变量时，你将获得完整的新闻 API。设置 GROQ_API_KEY（可在 console.groq.com 免费获取）即可启用 AI 端点。完整的变量列表、Kubernetes 清单和可观测性堆栈位于 docs/reference/self-hosting.md。

Docker

git clone https://github.com/nirholas/cryptocurrency.cv.git
cd cryptocurrency.cv
docker compose up -d
# API on http://localhost:3000/api/news

Dockerfile 会构建一个独立镜像；docker-compose.yml 会添加 Redis 用于缓存。横向扩展和可观测性变体：docker-compose.scale.yml、docker-compose.observability.yml。

Google Cloud Run

gcloud builds submit --config cloudbuild.yaml

分步指南，包含 Artifact Registry、密钥和自定义域名：docs/DEPLOY-GCP.md。

Vercel

使用 Vercel 部署

从源码部署

pnpm install
pnpm dev        # http://localhost:3000
pnpm build && pnpm start

Railway、Render、DigitalOcean、CasaOS、Unraid 和 Portainer 模板位于仓库根目录（railway.json、render.yaml、.do/、casaos-app.yaml、unraid-template.xml、portainer-template.json）。通用部署说明：docs/DEPLOYMENT.md。

🏗️ 架构

  1. Next.js 15 App Router 运行于 Edge 和 Node 运行时；src/app/api/ 包含所有路由处理程序。
  2. 来源注册表位于 src/lib/crypto-news.ts（按类别划分的 RSS 源）和 src/lib/international-sources.ts；来源可信度等级位于 src/lib/source-tiers.ts。
  3. 抓取层并行拉取订阅源，设置每个来源的超时，按内容哈希去重，并将内容规范化为上文所述的文章架构。
  4. 缓存分为三个层级：内存、Redis（可选）和 CDN s-maxage 标头，因此很少需要冷启动抓取。
  5. AI 层调用 Groq 生成摘要、情绪分析、事实核查和简报；RAG 将存档索引到 pgvector（docs/RAG.md）。
  6. 存档按月采用只追加的 JSONL 格式，并补充股票代码、实体、情绪和市场背景信息，通过 /api/archive 提供访问。
  7. 实时功能通过 SSE 和 WebSocket 服务端（ws-server.js）实现，数据来自同一抓取层。
  8. 支付：高级路由由 x402 控制；协调器位于 x402-facilitator/。这些路由发布的发现合约由 sdk/x402-conformance/ 审计，该工具也可独立使用：npx @nirholas/x402-conformance <origin>。
  9. Agent：MCP（托管于 /api/mcp，本地版本位于 mcp/）、OpenAPI、llms.txt 和 /.well-known/* 清单均根据同一份路由元数据生成。
  10. Web 应用：包含 89 个 React 服务端和客户端组件页面，可安装为 PWA，并本地化为 42 种语言。

深入阅读：docs/ARCHITECTURE.md、docs/reference/architecture.md、docs/SCALABILITY.md。

📚 文档

文档内容
开发者门户交互式端点浏览器
docs/API.mdAPI 参考，包含参数和示例
docs/QUICKSTART.md五分钟集成指南
docs/AI-FEATURES.mdAI 端点和 RAG
docs/sdks/各语言的客户端指南
docs/reference/本 README 中原有的所有内容：完整端点目录、页面、来源、归档、PWA、集成、部署、路线图
docs/USER-GUIDE.mdWeb 应用功能和键盘快捷键
AGENTS.md / SKILLS.mdAgent 集成指南和技能目录
CHANGELOG.md版本历史

🤝 参与贡献

欢迎提交 Bug 修复、新来源、翻译和文档。工作流程请参阅 CONTRIBUTING.md，提问渠道请参阅 SUPPORT.md，报告漏洞请参阅 SECURITY.md。贡献内容将根据下方的仓库许可协议予以接受。

  • 添加新闻来源：使用新来源模板提交 issue，或编辑 src/lib/crypto-news.ts。
  • 改进翻译：编辑 locales/ 下的文件。

🙏 贡献者

speraxos
Sperax
Code, Triage		cemitos
cemitos
Code		notmynamepls
notmynamepls
Code		yassais
yassais
Code, Docs		superchain
superchain
Docs		clankered
clankered
Docs		chenshj73
chenshj73
Security report
volumevigilante
volumevigilante
Bug report		cmdenney
cmdenney
Bug report		bomzj
bomzj
Bug report		RaoHammas
RaoHammas
Bug report		zhiqihuang
zhiqihuang
Bug report		3lang3
3lang3
Bug report		webparadoxer
webparadoxer
Bug report
AlestackOverglow
AlestackOverglow
Triage		lui62233
lui62233
Triage		niqv
niqv
Maintenance		Yash2341
Yash2341
Feedback

感谢所有编写代码、报告错误和安全问题，或帮助其他用户的人。每个人所做的贡献都列在 CONTRIBUTORS.md 中；同一份名单也发布在 cryptocurrency.cv/team 上。

📄 许可证

可获取源代码，保留所有权利。代码条款请参阅 LICENSE。

cryptocurrency.cv 上托管的 API 可免费使用，无论是否注明出处。自行运行代码、重新分发代码或构建竞争性的托管服务，都需要根据 LICENSE 中的条款获得许可。

⭐ Star 历史

Star 历史图表

支持项目

如果 cryptocurrency.cv 为你节省了时间，请在 GitHub 上为它点 Star。Star 能让其他开发者和 AI Agent 找到值得信赖的代码仓库，而且只需点击一次。

认识可能会用到它的人吗？在 X 上发布 · 分享到 Bluesky · 分享到 LinkedIn · 提交到 Hacker News · 分享到 Reddit

也为 AI Agent 打造

编码 Agent 和大模型工具可直接读取此代码库：AGENTS.md、llms.txt、llms-full.txt。将 https://github.com/nirholas/cryptocurrency.cv 提供给 Agent，它就能获取所需的上下文。

同一作者的更多项目

贡献者

贡献者

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。