mcpField
F
feedgrab-setup

feedgrab-setup

github.com/ibigqiang生产力62076 次安装4 天前更新
代码仓库

关于 feedgrab-setup

feedgrab-setup 是用于安装和配置 feedgrab 的技能，面向首次部署或排查环境的用户。它引导完成依赖安装、输出与 API 选项配置、平台登录及诊断验证。

主要功能

  1. 01检查 Python 和 pip 环境
  2. 02安装 feedgrab 软件包
  3. 03配置输出目录和 API 选项
  4. 04引导登录平台
  5. 05运行诊断和抓取测试

适用场景

  1. 01在 Python 环境中安装 feedgrab
  2. 02设置输出目录和可选密钥
  3. 03登录需要会话的平台
  4. 04排查安装与配置问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ibigqiang/feedgrab --skill feedgrab-setup

安装后在 Claude Code 中输入/feedgrab-setup确认已加载。

详细介绍

feedgrab 安装指南

安装 feedgrab、配置 API 密钥、登录平台，并验证一切正常。

触发条件

  • /feedgrab-setup
  • “安装 feedgrab”
  • “配置 feedgrab”
  • /feedgrab 报告“未找到 feedgrab”时

步骤 1：检查 Python 环境

python3 --version 2>/dev/null || python --version 2>/dev/null
pip3 --version 2>/dev/null || pip --version 2>/dev/null

需要 Python ≥ 3.10。如果不可用，请告知用户先安装 Python。

步骤 2：安装 feedgrab

pip install feedgrab[all]

这会安装包含所有可选依赖项（浏览器、stealth、Twitter、WeChat、Xiaohongshu、Feishu、Telegram）的完整软件包。

如需最精简安装：

pip install feedgrab                     # Core only (Jina fallback)
pip install feedgrab[browser]            # + Playwright
pip install feedgrab[twitter]            # + Twitter GraphQL
pip install feedgrab[stealth]            # + Anti-detection (patchright, curl_cffi)

安装后，验证：

feedgrab --help

步骤 3：交互式设置

feedgrab setup

这会运行一个包含 5 个步骤的交互式向导：

  1. 输出目录 — 保存抓取内容的位置（默认值：./output/）
  2. Jina API — 免费，无需密钥
  3. YouTube API 密钥 — 可选，用于 YouTube 搜索
  4. GitHub Token — 可选，用于提高速率限制
  5. 创建包含配置的 .env 文件

步骤 4：平台登录（按需）

对于需要 Cookie/会话的平台：

# Twitter/X — opens browser for login
feedgrab login twitter

# Xiaohongshu — opens browser for login
feedgrab login xhs

# WeChat MP backend — opens browser for login (session valid ~4 days)
feedgrab login wechat

# Feishu — opens browser for login
feedgrab login feishu

# Reddit — opens browser for login if Cloudflare/private content needs it
feedgrab login reddit

# LinuxDo / Discourse — opens browser for login
feedgrab login linuxdo

# IDCFlare / Discourse — opens browser for login
feedgrab login idcflare

# KDocs (金山文档) — opens browser for login
feedgrab login kdocs

# Zhihu (知乎) — opens browser for login
feedgrab login zhihu

# FlowUs (息流) — opens browser for login
feedgrab login flowus

提示：如果 Chrome 正在运行且已启用远程调试，可在 .env 中设置 CHROME_CDP_LOGIN=true，从现有浏览器会话提取 Cookie，无需重新登录。

步骤 5：验证安装

# Full diagnostic
feedgrab doctor

# Platform-specific diagnostic
feedgrab doctor x          # Twitter/X
feedgrab doctor xhs        # Xiaohongshu
feedgrab doctor mpweixin   # WeChat
feedgrab doctor feishu     # Feishu
feedgrab doctor reddit     # Reddit

步骤 6：测试

# Test with a simple URL (no login needed)
feedgrab https://github.com/iBigQiang/feedgrab

如果成功生成输出 .md 文件，说明设置已完成！

高级配置（.env）

主要环境变量（均为可选）：

# Output
OUTPUT_DIR=./output

# Proxy (optional)
FEEDGRAB_PROXY_ENABLED=false
FEEDGRAB_PROXY_URL=
FEEDGRAB_NO_PROXY=127.0.0.1,localhost

# Twitter
X_BOOKMARKS_ENABLED=true
X_USER_TWEETS_ENABLED=true
X_LIST_TWEETS_ENABLED=true
X_DOWNLOAD_MEDIA=true
X_SEARCH_LANG=zh
X_SEARCH_SORT=live

# Xiaohongshu
XHS_USER_NOTES_ENABLED=true
XHS_SEARCH_ENABLED=true
XHS_DOWNLOAD_MEDIA=true
XHS_FETCH_COMMENTS=true
XHS_PINIA_ENABLED=true

# WeChat
MPWEIXIN_DOWNLOAD_MEDIA=true
MPWEIXIN_FETCH_COMMENTS=true

# YouTube
YOUTUBE_API_KEY=your_key_here
YTDLP_COOKIES_BROWSER=chrome

# GitHub
GITHUB_TOKEN=your_token_here

# Feishu
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_secret
FEISHU_DOWNLOAD_IMAGES=true
FEISHU_CDP_ENABLED=false

# FlowUs
FLOWUS_CDP_ENABLED=true
FLOWUS_DOWNLOAD_IMAGES=false      # false=signed online URLs, true=local attachments

# LinuxDo / Discourse
LINUXDO_CDP_ENABLED=true
LINUXDO_PAGE_LOAD_TIMEOUT=15000
LINUXDO_REPLY_MODE=author

# IDCFlare / Discourse
IDCFLARE_CDP_ENABLED=true
IDCFLARE_PAGE_LOAD_TIMEOUT=15000
IDCFLARE_REPLY_MODE=author

# Reddit
REDDIT_CDP_ENABLED=true
REDDIT_REPLY_MODE=top          # top/tree/all
REDDIT_SEARCH_ENABLED=true
REDDIT_SEARCH_SORT=relevance
REDDIT_SEARCH_TIME_RANGE=all

# KDocs (金山文档)
KDOCS_CDP_ENABLED=false
KDOCS_DOWNLOAD_IMAGES=false

# Youdao Note (有道云笔记)
YOUDAO_DOWNLOAD_IMAGES=false

# Zhihu (知乎)
ZHIHU_CDP_ENABLED=false

# Bilibili subtitles / transcription
BILIBILI_SUBTITLE_LANG=zh-CN
BILIBILI_SUBTITLE_WHISPER=false

# Xiaoyuzhou / Ximalaya podcasts (require GROQ_API_KEY for transcription)
XIAOYUZHOU_WHISPER=true
XIMALAYA_WHISPER=true
GROQ_API_KEY=your_groq_key

# Paywall bypass (300+ news sites)
PAYWALL_ENABLED=true
PAYWALL_USE_AMP=true
PAYWALL_USE_ARCHIVE=true
PAYWALL_USE_GOOGLE_CACHE=true

# Stealth / CDP Cookie extraction
CHROME_CDP_LOGIN=true
CHROME_CDP_PORT=9222

完整列表请参阅 feedgrab 仓库中的 .env.example。

故障排查

问题解决方案
pip install 失败尝试运行 pip install --user feedgrab[all]，或使用虚拟环境
Playwright 无法正常工作运行 playwright install chromium
patchright 无法正常工作运行 patchright install chromium
Cookie 已过期重新运行 feedgrab login <platform>
Windows 编码错误feedgrab 会自动修复 UTF-8 编码，但请确保 Python ≥ 3.10

评论

支持 Markdown