DeepSFetch

English | Português

DeepSFetch 開発キット

⭐ これらの n8n ワークフロー、SDK、MCP ツールが時間の節約に役立った場合は、ぜひ GitHub でこのリポジトリに Star を付けてください！ 他の自動化開発者がこのツールキットを見つける助けになります。

完全版マニュアル：33 のステップバイステップガイド — API、MCP、SDK、CLI、コレクション、モニター、ファイル、インテグレーション、課金について説明します。

明示的なクレジット上限を設定して、AI エージェントや自動化向けにウェブコンテンツを収集できます。

ホスト型 DeepSFetch API向けのオープンソース JavaScript および Python クライアント、CLI、n8n インテグレーションコードを提供しています。まずは公開 HTML ページを 1 つ指定して結果を確認し、そこから構築を進めてください。

このリポジトリにはクライアント側のツールが含まれています。収集エンジンとホスト型サービスは含まれていません。サンプルを実行するには DeepSFetch アカウントと API キーが必要です。収集にはワークスペースのクレジットを消費します。現在のプランをご覧ください。

すぐに使える n8n ワークフローとコミュニティノード

明示的なクレジット上限、冪等性キー、フィールド検証を設定して、構造化 HTML 抽出を n8n で自動化し、データをアラート、スプレッドシート、AI/RAG パイプラインに送信できます。

すぐに使えるテンプレート	用途	抽出・提供する内容	設定とダウンロード
価格モニタリング	スケジュールに従って商品の価格変動を追跡	検証済みの name、price、currency（JSON-LD / CSS）と基準値との比較	設定して JSON をダウンロード · n8n ガイド
商品カタログ	一覧ページから最大 100 件の商品を抽出	商品ごとのフィールド検証を行った構造化配列（ページネーションなし）	設定して JSON をダウンロード · n8n ガイド
AI / RAG ドキュメント	整理されたドキュメントをベクトルストアや LLM に取り込む	ソースメタデータ、安定したドキュメント ID、コンテンツハッシュ（変更検出）、チャンク	設定して JSON をダウンロード · n8n ガイド

n8n コミュニティノード（n8n-nodes-deepsfetch）をインストールする

セルフホスト可能な n8n の場合は、UI（Settings → Community Nodes → Install → n8n-nodes-deepsfetch）からインストールするか、コミュニティノードフォルダーに手動でインストールしてください。

npm install n8n-nodes-deepsfetch

(n8n Cloud をご利用ですか？コミュニティノードをインストールしなくても、ガイド付きセットアップから標準の HTTP Request ワークフローテンプレートを直接ダウンロードできます。)

📸 n8n ノードの設定と検証済み JSON 出力のスクリーンショットを表示

1. 収集を開始（ペイロードと言語を選択する Start Collection 操作）：

2. 検証済みの出力と価格比較（構造化 JSON 結果を使う Compare price ステップ）：

最初の結果を取得する

Node.js 22 以降が必要です。API キーでキーを作成してください。リポジトリのルートから、現在のターミナルセッションにキーを設定して、依存関係不要のサンプルを実行します。

PowerShell：

$env:DEEPSFETCH_API_KEY = 'YOUR_DEEPSFETCH_API_KEY'
node examples/scrape.mjs https://example.com

macOS / Linux：

export DEEPSFETCH_API_KEY='YOUR_DEEPSFETCH_API_KEY'
node examples/scrape.mjs https://example.com

このサンプルは、DeepSFetch クレジットの上限を 3 に設定し、ブラウザフォールバックを無効にして、HTTP のみで収集を 1 件送信した後、同じジョブをポーリングします。完了したジョブを JSON として出力します。この上限は、無料で収集できることや、収集の成功を保証するものではありません。JavaScript に依存するページには別の設定が必要です。エラー処理とジョブの再開方法については、スタートガイドをご覧ください。

インテグレーションを選択

ツール	インストールまたはガイド	内容
JavaScript SDK	npm install @deepsfetch/sdk	API v2 クライアントとジョブのポーリング
CLI	npm install -g @deepsfetch/cli	コレクション、ジョブ、見積もり用のコマンド
Python SDK	python -m pip install ./packages/deepsfetch-sdk-python	ソースからのインストール。PyPI でのリリースは保留中です
MCP	リモート接続ガイド	ホスト型 MCP エンドポイントの設定
n8n	npm install n8n-nodes-deepsfetch · ガイド	npm で公開されているコミュニティノードのソース

リモート MCP サーバーの実装はここには含まれていません。n8n ノードは n8n による検証を受けていません。リモート MCP は公式レジストリに掲載されています。このリポジトリでは、ネイティブパートナーシップやセルフホスト可能なコレクションエンジンを提供しているとは主張していません。

CLI クイックスタート

CLI をインストールし、上記の環境変数を設定した後：

deepsfetch scrape --file examples/scrape-request.json --wait

CLI は冪等性キーを標準エラー出力に書き込みます。送信結果が不明な場合は、同じリクエストを --idempotency-key THE_SAME_KEY を指定して再試行してください。ジョブ ID を取得したら、別のコレクションを送信するのではなく、deepsfetch job JOB_ID --wait を使用してください。

オープンツールとホスト型サービス

機能	このリポジトリ	ホスト型 DeepSFetch
JavaScript SDK、Python SDK、CLI	ソースとテスト	API v2 に接続
n8n コミュニティノード	JavaScript として配布されるソース	コレクション統合エンドポイントを呼び出します
MCP	接続ガイド	リモートサーバー
コレクションエンジン、ブラウザーインフラストラクチャ	含まれていません	DeepSFetch が管理
アカウント、クレジット、請求、ダッシュボード	含まれていません	DeepSFetch が管理

ローカルで開発する

npm install --ignore-scripts
npm test
npm run check

Python のテストはリポジトリのルートから実行してください：

python -m pip install ./packages/deepsfetch-sdk-python
python -m unittest discover -s packages/deepsfetch-sdk-python/tests

テストではフィクスチャとローカル HTTP サーバーを使用し、有料コレクションは送信しません。コントリビューションガイド、セキュリティ、ロードマップをご覧ください。

リソース

• API ドキュメント
• プレイグラウンド
• n8n のセットアップ
• サポート

このリポジトリ内のツールには MIT ライセンスが適用されます。ホスト型サービスの利用には、サービス独自の利用規約とクレジット上限が適用されます。

試してフィードバックを共有する

初回コレクションのチュートリアルを読み、運用スモークテストを実行して、初回実行の感想を共有してください。

認証済み Firecrawl 比較には、結果、制限事項、再現可能なコードが含まれています。公開済みの DEV チュートリアルでは、登録、初回コレクション、MCP の手順を説明しています。Smithery の掲載ページもご覧ください。手順と制限事項については、MCP ガイドをご確認ください。