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]

これにより、すべてのオプションの依存関係（ブラウザー、ステルス、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 トークン — オプション。レート制限を緩和します
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 を使用してください