jina-web-fetch について
jina-web-fetchは、まず直接取得を試し、失敗またはブロックが疑われる場合にjina.aiへ切り替えるウェブ取得スキルです。生の取得結果を追跡可能な形で保存し、使用した取得経路も表示します。
主な機能
- 01直接取得を優先
- 02ブロック時にjina.aiで再試行
- 03取得内容をファイルに保存
- 04使用した取得経路を表示
- 05タイムアウトとフォールバックの設定
活用シーン
- 01直接取得しにくいページの内容を収集
- 02監査用に生のページテキストを保存
- 03JavaScript必須またはアクセス制限のあるページを取得
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ xiaojiongqian/ skills-hub --skill jina-web-fetchインストール後、Claude Code で/jina-web-fetchを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlscripts/fetch_with_jina_fallback.sh
詳細
Jina Web Fetch
取得しにくいページのコンテンツを、決定論的なワークフローを保ちながら取得するには、このスキルを使用します。
- まず直接取得を試みます。
- 直接取得に失敗するか、ブロックされているように見える場合は、
jina.ai経由で再試行します。
クイックスタート
bash "<path-to-skill>/scripts/fetch_with_jina_fallback.sh" "<url>" "<output_file>"
例:
bash "<path-to-skill>/scripts/fetch_with_jina_fallback.sh" \
"https://x.com/trq212/status/2027463795355095314" \
"raw/x-status.txt"
スクリプトは、使用した経路を確認できるように、source=direct または source=jina を stderr に出力します。
output_file を省略すると、コンテンツは stdout に出力されます。
デフォルトのワークフロー
- 対象の URL を指定してスクリプトを実行します。
- トレース可能なパス(
raw/<slug>.txtなど)に生出力を保存します。 - 抽出したテキスト/Markdown を解析し、以下を取得します。
- 本文
- メディアリンク(画像/動画)
- 参照先 URL
- 監査可能性を保つため、元の URL と生キャプチャを一緒に保管します。
ブロック判定のヒューリスティクス
直接取得したコンテンツが次のように見える場合、スクリプトは自動的に jina.ai にフォールバックします。
- ログイン画面/サインアップのプロンプト
- JavaScript が必要なページ
- ボット対策/CAPTCHA/アクセス拒否のページ
- 非常に小さい、シェルのような HTML ページ(デフォルトのしきい値は
< 800バイト)
環境変数の設定項目
FETCH_TIMEOUT(デフォルト:25)FETCH_CONNECT_TIMEOUT(デフォルト:10)FETCH_MIN_BYTES(デフォルト:800)JINA_FORCE=1を指定すると、直接取得をスキップして常にjina.aiを使用します
URL 形式に関する注意
フォールバック URL は次の形式で構成されます。
https://r.jina.ai/http://<original-host-and-path>
コメント
Markdown 対応