wechat-article-reader について
WeChat公式アカウントの記事リンクを読み取り、メタデータと本文を構造化して返すスキルです。再試行処理や実行ログを含む記事取得ワークフローに適しています。
主な機能
- 01タイトル、著者、日時の解析
- 02本文のプレーンテキスト抽出
- 03リクエスト失敗時の再試行
- 04取得方式と実行ログの出力
- 05JSON形式での結果返却
活用シーン
- 01WeChat記事本文の抽出
- 02著者と公開日時の取得
- 03記事取得失敗の原因調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pangahn/ wechat-article-reader --skill wechat-article-readerインストール後、Claude Code で/wechat-article-readerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
requirements.txt.gitignoreuv.lockpyproject.tomlscripts/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/..."
パラメーターの説明
| パラメーター | デフォルト値 | 説明 |
|---|---|---|
--timeout | 20 | 1 回のリクエストのタイムアウト秒数 |
--max-retries | 3 | 最大試行回数 |
--retry-delay | 1.0 | 再試行時の基準待機秒数(指数バックオフ) |
出力の説明
成功時は、以下の JSON が返されます。
| フィールド | 説明 |
|---|---|
title | 記事のタイトル |
author | 著者名 |
pub_time | 公開日時 |
content | 本文のプレーンテキスト |
source_url | 元のリンク |
strategy | 実際に使用した取得戦略 |
logs | 実行ログ(問題の調査に使用) |
失敗時は、以下が返されます。
| フィールド | 説明 |
|---|---|
error | エラーの種類 |
message | エラーの詳細 |
source_url | 元のリンク |
strategy | 最後に試行した戦略 |
logs | 実行ログ |
コメント
Markdown 対応