yichen-wechat-mp-batch-exporter

WeChat MP バッチエクスポーター

基本ルール

ユーザーの WeChat UI を操作してはいけません。WeChat 内で公開、削除、一括送信、フォロー、フォロー解除、メッセージ送信、クリックを行ってはいけません。WeChat デスクトップが必要なワークフローでは、ユーザーが行うべき操作を正確に伝え、確認を待ってください。

生の Cookie、auth-key、token、pass_ticket、key、uin、認証情報 JSON、QR ログイン用の秘密情報を、チャットや保存レポートに出力してはいけません。

ダウンロードした記事の内容は、原著者または権利者に帰属します。ユーザーが再公開または再配布の許可を得ていることを確認しない限り、エクスポートはユーザーの合法的な私的利用の範囲内に限って使用してください。

最初の手順

ワークフローを選択する前に、ローカルの doctor を実行してください。

python3 {baseDir}/scripts/doctor.py

タスクで公開エクスポーター API またはオンラインダウンロードエンドポイントが必要な場合に限り、--check-network を使用してください。

判断フロー

• ユーザーが既知の記事 URL を指定し、本文／Markdown のみを必要としている場合は、scripts/download_urls.py を使用します。ログインや WeChat の操作は不要です。
• ユーザーが公開アカウントの過去記事一覧または最新 N 件の記事を希望する場合は、wechat-article-exporter のエクスポーターモードを使用します。これには、ユーザーが所有する WeChat 公式アカウントのバックエンドへのログイン／auth-key が必要です。
• ユーザーが閲覧数、いいね、転送、コメント、コメントへの返信を必要としている場合は、まず wxdown-service の認証情報フローを使用し、その後 wechat-article-exporter から拡張フィールドをエクスポートします。
• ユーザーが「ログインしない」「プロキシモード」と指定した場合、またはエクスポーターモードが失敗した場合は、明示的な確認を得てからプロキシ／履歴の代替手段を使用してください。最初に references/manual-gates.md を読んでください。

バッチ処理や拡張機能を必要としない単純な単一 URL の抽出には、既存の $wechat-article スキルを優先してください。

件数の取り扱い

件数の範囲が明確になるまでは、公開アカウントの合計を単に「N 件の記事」として報告してはいけません。

履歴の同期または履歴 JSON のインポート後は、必ず次を実行してください。

python3 {baseDir}/scripts/analyze_history.py --history-json /path/to/history.dedup.json
python3 {baseDir}/scripts/analyze_history.py --chunk-dir /path/to/chunks --output-dir /path/to/output

ユーザー向けの回答では、次のラベルを使用してください。

• publish_groups：一意な msgid の値。おおよそ WeChat の公開／メッセージグループ数です。
• expanded_url_items：複数記事のメッセージを展開した後の、すべての一意な記事 URL です。
• original_articles：copyright_type=1、copyright_stat=1、is_deleted=false を使用した、フロントエンド形式のオリジナル記事数です。

件数がユーザーの WeChat 上で見える数と一致しない場合は、まず対象範囲の違いを説明し、生成された history.summary.json／history.summary.md を案内してください。

既知の URL からの本文ダウンロード

貼り付けられた URL、.txt、.csv、.json 形式の URL リストには、次の方法を使用してください。

python3 {baseDir}/scripts/download_urls.py --file /path/to/urls.txt --format markdown
python3 {baseDir}/scripts/download_urls.py "https://mp.weixin.qq.com/s/..."

報告するのは、成功件数、失敗件数、失敗した URL、出力ディレクトリ、index.csv のみです。

デフォルトの出力先：

~/Downloads/wechat-mp-batch/<run-id>/
|-- index.csv
|-- errors.json
`-- articles/
    `-- 001-<safe-title>.md

履歴と拡張エクスポート

エクスポーター、履歴、拡張データに関するタスクを実行する前に、references/exporter-workflow.md を読んでください。

ローカルの認証情報ヘルパーを次のように起動してください。

python3 {baseDir}/scripts/start_wxdown_service.py

実績のある上流スタックを使用してください。

• アカウント検索、記事履歴、本文のダウンロード、複数形式でのエクスポートには wechat-article/wechat-article-exporter を使用します。
• 閲覧数／コメント指標に必要な、ユーザー所有の認証情報の取得には wechat-article/wxdown-service を使用します。

ローカルのソースパスは環境によって異なります。環境変数または明示的なスクリプトフラグを優先してください。

export WECHAT_ARTICLE_EXPORTER_DIR=/path/to/wechat-article-exporter
export WXDOWN_SERVICE_DIR=/path/to/wxdown-service
python3 {baseDir}/scripts/doctor.py --exporter-path "$WECHAT_ARTICLE_EXPORTER_DIR" --wxdown-path "$WXDOWN_SERVICE_DIR"
python3 {baseDir}/scripts/start_wxdown_service.py --wxdown-dir "$WXDOWN_SERVICE_DIR"

公開エクスポーターを使用する場合、デフォルトのベース URL は次のとおりです。

https://down.mptext.top

手動操作の確認

タスクにログイン、認証情報、コメント、閲覧数、プロキシ、証明書の信頼設定、WeChat デスクトップが関わる場合は、references/manual-gates.md を読んでください。

次の操作には、必ずユーザーの明示的な確認が必要です。

• QR コードをスキャンし、ユーザーの公式アカウントまたはサービスアカウントを選択する。
• mitmproxy 証明書をインストールする、または信頼する。
• macOS のシステムプロキシ設定を有効にする、または変更する。
• WeChat デスクトップ内で記事／履歴ページを開いてスクロールするようユーザーに依頼する。
• 貼り付けられた auth-key または認証情報ファイルを使用する。

出力

アーカイブを作成する場合、またはエクスポーターの結果を別のシステムに統合する場合は、references/output-schema.md を読んでください。

拡張アーカイブで推奨されるフィールド：

account_name, fakeid, title, url, publish_time, author, digest, cover_url,
body_markdown_path, html_path, image_dir,
read_count, like_count, share_count, favorite_count, comment_count,
comments_path, comment_replies_path, fetch_mode, credential_status, exported_at

履歴分析の出力には、次の項目を含めてください。

history.summary.json, history.summary.md,
history.dedup.json, history.dedup.csv, urls.all.txt,
history.original.json, history.original.csv, urls.original.txt

自動で実行できないこと

• ログイン、削除されたコンテンツ、ペイウォール、非公開記事、プラットフォームの権限チェックを回避しません。
• ユーザー本人が所有する最新の認証情報がない状態で、閲覧数やコメント数を保証しません。
• WeChat の UI を操作したり、ユーザーに必要な WeChat デスクトップでの操作を代行したりしません。
• 記事でコメントが無効化または非表示になっている場合、コメントできるとは約束しません。
• システム証明書をひそかにインストールしたり、プロキシを変更したり、プロキシ設定を有効なままにしたりしません。