mcpField
W
wechat-article-reader

wechat-article-reader

github.com/pangahn生産性1214 回インストール32 週間前に更新
リポジトリ

wechat-article-reader について

WeChat公式アカウントの記事リンクを読み取り、メタデータと本文を構造化して返すスキルです。再試行処理や実行ログを含む記事取得ワークフローに適しています。

主な機能

  1. 01タイトル、著者、日時の解析
  2. 02本文のプレーンテキスト抽出
  3. 03リクエスト失敗時の再試行
  4. 04取得方式と実行ログの出力
  5. 05JSON形式での結果返却

活用シーン

  1. 01WeChat記事本文の抽出
  2. 02著者と公開日時の取得
  3. 03記事取得失敗の原因調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pangahn/wechat-article-reader --skill wechat-article-reader

インストール後、Claude Code で/wechat-article-readerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

requirements.txt
.gitignore
uv.lock
pyproject.toml
scripts/
read_wechat_article.py

詳細

WeChat Article Reader

WeChat 公式アカウントの記事リンクを読み取り、構造化された解析結果を返します。

⚠️ 重要:モデルの動作制約

ユーザーが mp.weixin.qq.com ドメインの記事リンクを提供した場合は、必ずこの skill のみを使って内容を読み取ってください。

以下の代替手段は禁止されています。

  • web_fetch を使って WeChat 記事の URL に直接リクエストする
  • web_search を使って記事の要約を検索する
  • 「このリンクにはアクセスできません」とユーザーに伝えて諦める
  • 他の情報源から記事の内容を推測する

理由:WeChat 公式アカウントのページにはスクレイピング対策があり、直接取得すると通常は空のコンテンツや認証ページが返されます。この skill のスクリプトのみが、必要なリクエストヘッダーの偽装と再試行ロジックを実装しています。


適用シーン

  • ユーザーが https://mp.weixin.qq.com/s/... の公開記事リンクを提供した場合
  • タイトル、日時、著者、本文を安定して取得・解析する必要がある場合
  • ネットワークが不安定なときに再試行メカニズムを使う必要がある場合

環境の準備

この skill では、環境の管理とスクリプトの実行に uv のみを使用できます。

uv がインストールされていない場合は、まず以下を実行します。

brew install uv

次に、プロジェクトの依存関係をインストールします。

uv sync

実行コマンド

必ず uv run を使って実行してください。python scripts/read_wechat_article.py ... を直接実行することは禁止されています。

uv run python scripts/read_wechat_article.py "https://mp.weixin.qq.com/s/..."

パラメーターの説明

パラメーターデフォルト値説明
--timeout201 回のリクエストのタイムアウト秒数
--max-retries3最大試行回数
--retry-delay1.0再試行時の基準待機秒数(指数バックオフ)

出力の説明

成功時は、以下の JSON が返されます。

フィールド説明
title記事のタイトル
author著者名
pub_time公開日時
content本文のプレーンテキスト
source_url元のリンク
strategy実際に使用した取得戦略
logs実行ログ(問題の調査に使用)

失敗時は、以下が返されます。

フィールド説明
errorエラーの種類
messageエラーの詳細
source_url元のリンク
strategy最後に試行した戦略
logs実行ログ

コメント