多平台新闻 & 内容爬虫集合简介

目录

 

NewsCrawler

🎯 为什么选择 NewsCrawler?

🚀 快速开始

方式一:Docker ***pose (⭐ 推荐 - 一键部署)

方式二:Web UI (手动部署)

方式三:Python API (适合自动化集成)

方式四:MCP Server (AI 智能体集成)

📦 支持的平台

新闻 / 内容平台

视频素材平台

💡 使用场景

📊 数据输出格式

🔧 技术架构

后端技术

前端技术

开发工具

项目结构

⚠️ 重要提醒


 

NewsCrawler

多平台新闻 & 内容爬虫集合

支持微信公众号、今日头条、网易新闻、搜狐、腾讯、Naver、Detik、Quora、BBC、***N 等 11 个主流平台

提供命令行调用、可视化 Web UI、统一 JSON 输出、支持MCP协议

 

 

 

English · 中文


开箱即用的 Web UI - 自动识别平台、实时提取进度、JSON/Markdown 双格式导出


🎯 为什么选择 NewsCrawler?

🌍 多平台支持 🎨 双模式使用 📦 标准化输出 ⚡ 快速部署 🤖 MCP 支持
11 个主流平台
覆盖中英韩印尼
Python API
+ Web UI
统一 JSON 格式
易于集成
uv 包管理器
极速安装
集成各类AI总结文章

核心特性:

  • ✅ 全平台覆盖 - 支持微信公众号、今日头条、网易、搜狐、腾讯、Lenny's Newsletter、Naver Blog、Detik News、Quora、BBC News、***N News
  • ✅ 智能提取 - 自动识别平台类型,提取标题、正文、图片、视频等多媒体内容
  • ✅ 统一输出 - 所有平台输出标准化 JSON 格式,完美适配数据分析、入库、下游处理
  • ✅ 灵活使用 - 支持 Python API(自动化) + Web UI(可视化) + MCP Server(AI Agent)
  • ✅ 一键部署 - Docker ***pose 编排所有服务(后端 + 前端 + MCP)
  • ✅ AI 智能体集成 - 支持 MCP 协议,可接入 Claude Desktop 等 AI 工具
  • ✅ 模块化设计 - 各平台爬虫解耦,易于扩展新平台或优化现有实现
  • ✅ 轻量高效 - 使用 uv 管理依赖,安装快速,运行稳定

🚀 快速开始

方式一:Docker ***pose (⭐ 推荐 - 一键部署)

# 1. 安装 Docker 和 Docker ***pose
# 访问: https://docs.docker.***/get-docker/

# 2. 克隆项目
git clone https://github.***/NanmiCoder/NewsCrawler.git
cd NewsCrawler

# 3. 一键启动所有服务(后端 + 前端 + MCP)
docker ***pose up -d

# 4. 访问服务
# - 前端界面: http://localhost:3000
# - 后端 API: http://localhost:8000/docs
# - MCP 服务: http://localhost:8765/mcp

包含服务:

  • ✅ Backend 服务 (FastAPI) - 新闻提取 API
  • ✅ Frontend 服务 (Vue 3 + Nginx) - Web UI 界面
  • ✅ MCP 服务 - AI Agent 工具(支持 Claude Desktop)
  • ✅ 自动健康检查 - 确保所有服务正常运行
  • ✅ 数据持久化 - 提取的新闻保存在 ./data/ 目录

Docker 管理命令:

# 查看日志
docker ***pose logs -f

# 停止服务
docker ***pose down

# 代码更新后重新构建
docker ***pose up -d --build

📖 完整文档: DOCKER_DEPLOYMENT.md


方式二:Web UI (手动部署)

# 1. 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh  # macOS/Linux
# 或: pip install uv

# 2. 克隆项目
git clone https://github.***/NanmiCoder/NewsCrawler.git
cd NewsCrawler

# 3. 安装所有依赖 (uv workspace 模式)
uv sync

# 4. 启动后端 (在项目根目录)
uv run news-extractor-backend --host 0.0.0.0 --port 8000

# 5. 启动前端 (新终端)
cd news-extractor-ui/frontend
npm install && npm run dev

# 6. 访问 http://localhost:3000

Web UI 功能:

  • 🎯 粘贴 URL,自动识别平台类型
  • 📊 实时显示提取进度
  • 📄 支持 JSON / Markdown 双格式导出
  • 🖼️ 内容预览与一键下载

方式三:Python API (适合自动化集成)

from news_crawler.wechat_news import WeChatNewsCrawler
from news_crawler.toutiao_news import ToutiaoNewsCrawler

# 微信公众号
wechat_url = "https://mp.weixin.qq.***/s/xxxxxx"
crawler = WeChatNewsCrawler(wechat_url)
result = crawler.run()  # 自动保存到 data/ 目录

# 今日头条
toutiao_url = "https://www.toutiao.***/article/xxxxxx"
crawler = ToutiaoNewsCrawler(toutiao_url)
result = crawler.run()

print(result)  # 返回 JSON 格式数据

运行示例:

uv run call_example.py  # 查看完整示例

方式四:MCP Server (AI 智能体集成)

什么是 MCP? Model Context Protocol (MCP) 是一个连接 AI 助手(如 Claude Desktop)与外部工具和数据源的标准协议。

使用场景:

  • 🤖 让 Claude、Cursor、ChatGPT等工具通过对话直接提取新闻内容
  • 🔄 通过 AI 指令批量处理多个 URL
  • 📊 AI 驱动的内容分析工作流
  • 🚀 构建具有新闻提取能力的自定义 AI 智能体

快速配置:

# 1. 启动 MCP 服务(推荐使用 Docker)
docker ***pose up -d mcp

# 2. 或手动启动 (在项目根目录)
# 首先安装依赖
uv sync

# 启动 MCP 服务器
uv run news-extractor-mcp --host 0.0.0.0 --port 8765

# 3. MCP 服务运行在: http://localhost:8765/mcp

AI 工具配置 (Streamable HTTP 方式):

Cursor (点击展开)

配置文件位置: ~/.cursor/mcp.json (全局) 或 .cursor/mcp.json (项目级别)

{
  "mcpServers": {
    "newscrawler": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

Windsurf (点击展开)

配置文件位置: ~/.codeium/windsurf/mcp_server_config.json

{
  "mcpServers": {
    "newscrawler": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

Trae (点击展开)

设置 → 工具 → MCP 服务器 → 添加服务器

{
  "name": "newscrawler",
  "url": "http://127.0.0.1:8765/mcp"
}

Claude Desktop (点击展开)

配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "newscrawler": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

其他支持 MCP 的工具 (点击展开)

所有支持 Streamable HTTP 传输的 MCP 客户端都可以使用以下配置:

{
  "mcpServers": {
    "newscrawler": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

注意: 如果使用 Docker 且 AI 工具运行在 Docker 外,请将 127.0.0.1 替换为宿主机 IP 或 host.docker.internal

可用 MCP 工具:

  • extract_news - 提取单篇新闻(JSON 或 Markdown 格式)
  • batch_extract_news - 批量提取多个 URL
  • detect_news_platform - 从 URL 识别平台类型
  • list_supported_platforms - 显示所有支持的平台

📖 完整 MCP 文档: news_extractor_mcp/README.md


📦 支持的平台

新闻 / 内容平台

平台 URL 示例 语言 特性
微信公众号 mp.weixin.qq.*** 中文 支持图文提取
今日头条 toutiao.*** 中文 富媒体内容
网易新闻 163.*** 中文 图片画廊支持
搜狐新闻 sohu.*** 中文 多媒体内容
腾讯新闻 news.qq.*** 中文 新闻支持
Lenny's Newsletter lennysnewsletter.*** 英文 长文内容
Naver Blog blog.naver.*** 韩语 博客平台
Detik News detik.*** 印尼语 东南亚新闻
Quora quora.*** 英文 问答内容

视频素材平台

Pexels · Pixabay · Coverr · Mixkit - 高质量免费视频素材下载


💡 使用场景

📰 多源新闻聚合平台 / 舆情监控系统
📊 媒体内容分析、数据挖掘、推荐系统
🔬 学术研究 / 数据科学 - 跨平台内容抓取
🎓 教学项目 / 个人学习 - 爬虫框架模板
🤖 AI 训练数据采集 / 内容质量分析

📊 数据输出格式

所有爬虫输出统一的 JSON 格式,保存在 data/ 目录:

{
  "title": "文章标题",
  "news_url": "原文链接",
  "news_id": "文章ID",
  "meta_info": {
    "author_name": "作者名称",
    "author_url": "作者主页",
    "publish_time": "2024-10-15 10:30:00"
  },
  "contents": [
    {"type": "text", "content": "段落文本内容", "desc": ""},
    {"type": "image", "content": "https://example.***/image.jpg", "desc": "图片描述"},
    {"type": "video", "content": "https://example.***/video.mp4", "desc": "视频描述"}
  ],
  "texts": ["段落1文本", "段落2文本"],
  "images": ["图片URL1", "图片URL2"],
  "videos": ["视频URL1"]
}

字段说明:

  • contents - 结构化内容,保留顺序和类型(文本/图片/视频)
  • texts/images/videos - 扁平化列表,便于快速访问特定类型内容
  • meta_info - 文章元信息(作者、发布时间等)

🔧 技术架构

后端技术

Python 3.8+ · FastAPI · Pydantic · curl_cffi · parsel · tenacity

前端技术

Vue 3 · TypeScript · Vite · Axios

开发工具

uv (包管理器) · Playwright (浏览器自动化,可选)

项目结构

NewsCrawler/
├── news_crawler/              # 核心爬虫模块
│   ├── wechat_news/          # 微信公众号
│   ├── toutiao_news/         # 今日头条
│   ├── ***ease_news/         # 网易新闻
│   ├── sohu_news/            # 搜狐新闻
│   ├── tencent_news/         # 腾讯新闻
│   └── ...                   # 其他平台
│
├── news_extractor_core/       # 共享核心库 (uv workspace 成员)
│   ├── adapters/             # 平台适配器
│   ├── services/             # 业务逻辑
│   └── models/               # 数据模型
│
├── news_extractor_backend/    # FastAPI 后端服务 (uv workspace 成员)
│   ├── api/                  # API 路由
│   ├── main.py               # 应用入口
│   └── cli.py                # 命令行入口
│
├── news_extractor_mcp/        # MCP 服务器 (uv workspace 成员)
│   ├── server.py             # MCP 实现
│   └── README.md             # MCP 文档
│
├── news-extractor-ui/         # Web UI 应用
│   └── frontend/             # Vue 3 前端
│
├── video_crawler/             # 视频素材下载器
├── libs/                      # 工具库
├── data/                      # 输出数据目录
│
├── pyproject.toml             # uv workspace 根配置
├── uv.lock                    # 依赖锁文件
├── Dockerfile                 # 多阶段 Docker 构建
├── docker-***pose.yml         # 服务编排配置
├── DOCKER_DEPLOYMENT.md       # Docker 部署指南
└── MANUAL_DEPLOYMENT.md       # 手动部署指南

⚠️ 重要提醒

本项目仅供学习和研究使用,禁止用于商业用途

使用须知:

  • ✅ 仅用于个人学习、研究、教学目的
  • ✅ 遵守目标网站的 robots.txt 和服务条款
  • ✅ 控制请求频率,避免给服务器造成压力
  • ❌ 不得用于非法用途或侵犯他人权益
  • ❌ 不得进行大规模商业化爬取

技术说明:

  • 部分平台可能有反爬机制,需适当调整策略
  • 默认 Headers 可能过期,可使用 Playwright 自动获取最新 Cookie
  • 网页结构变化可能导致解析失败,欢迎提交 Issue
转载请说明出处内容投诉
CSS教程网 » 多平台新闻 & 内容爬虫集合简介

发表评论

欢迎 访客 发表评论

一个令你着迷的主题!

查看演示 官网购买