ヘルメスエージェント + スクラップレスMCP: ウェブ対応AIアシスタントの構築
Scraping and Proxy Management Expert
TL;DR:
- Hermes Agentは、Scrapelessをローカルstdio MCPサーバーとしてロードし、起動時にそのウェブツールを発見できます。
- 検証済みのセットアップは、Hermesに8つの選択されたツールを公開し、接続テストはサーバー上の24のツールを発見しました。
- ツールの許可リストは、エージェントの可視面を検索、抽出、および制限されたブラウザワークフローに集中させます。
- 成功したMCPハンドシェイクは接続性とスキーマの発見を証明します。ライブウェブコールには有効なScrapelessキーが依然として必要です。
Hermes Agentはすでにツールについての推論方法を知っています。役立つ統合の質問はより狭いです：エージェント自体の内部にブラウザオートメーション、検索、および抽出ロジックを埋め込むことなく、現在のウェブ証拠をどのように得ることができますか？
MCPが境界を提供します。Hermesはクライアントとして機能します。Scrapelessはツールサーバーとして実行されます。このモデルはフィルタリングされた型付き操作のセットを見ており、認証情報はプロンプト内ではなく、サーバー環境内に留まります。
Hermes AgentとScrapeless MCPでできること
接続は、ウェブを意識したエージェントジョブの実用的なセットをサポートします：
- Googleを検索し、構造化された結果をエージェントに返します；
- ページのコンテンツをMarkdownとして抽出し、研究や要約に使用します；
- JavaScriptが重いページのためにクラウドブラウザセッションを作成します；
- ナビゲートし、インタラクティブな要素を調査し、クリックし、タイプし、可視テキストを読むことができます；
- ウェブ操作のトレースをモデルの解釈とは別に保持します。
HermesはMCPツールをそのネイティブツールとともに登録します。そのMCPガイドは、ローカルstdioおよびリモートHTTPサーバー、自動発見、およびサーバーごとのフィルタリングについて文書化されています。つまり、すでにMCPを話すサーバーにはカスタムHermesプラグインは必要ありません。
Scrapeless MCPサーバーを使用する理由は？
通常のHTTPフェッチは静的ページに対しては機能します。ライブウェブを調査するエージェントは、JavaScript、インタラクティブなコントロール、位置情報、または維持されたセッションに依存するページに早く直面します。Scrapelessサーバーは、検索、抽出、クローリング、およびブラウザアクションを1つのMCP接続の背後にまとめます。
公式のScrapeless MCPサーバーリポジトリは、stdioとストリーミングHTTPトランスポートの両方について文書化しています。このガイドはstdioを使用しています。なぜなら、それがHermesに明確なライフサイクルと小さな構成フットプリントを持つローカル子プロセスを提供するからです。
MCPの代わりにCDPを介した直接のブラウザ接続を使用するには、別のHermes AgentとScraping Browserガイドを使用してください。これらの2つのアプローチは異なる統合の問題を解決します：CDPはブラウザ接続を公開し、MCPはHermesが発見しフィルター可能な型付きツールを公開します。
前提条件
Hermesの設定を編集する前に、これらを準備してください：
- Hermesを実行しているマシン上のGit、Node.js、および
npx； - 現在のHermesリリースがサポートするバージョン範囲のPython；
- ScrapelessアカウントおよびAPIキー；
hermesが意図したインストールに解決されるターミナル。
APIキーをMarkdown、シェルの履歴、およびエージェントのプロンプトからは外しておいてください。Scrapelessドキュメントでは、認証情報を作成および管理する場所について説明しています。
Hermes AgentをScrapeless MCPに接続
MCPサポートでHermesをインストール
標準のHermesインストーラーにはすでにMCPサポートが含まれています。孤立したソースインストールの場合、以下のシーケンスは、チェックアウトと仮想環境を1つのディレクトリに固定するために便利です。
bash
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
python3.12 -m venv .venv
./.venv/bin/pip install -e '.[mcp]'
./.venv/bin/hermes --versionこのシーケンスは、Python 3.12.13でHermes Agent v0.20.5に対して実行されました。公式インストールガイドは、起動プログラムとサポート依存関係を管理するため、通常のエンドユーザーインストールのための優先パスとなります。
stdioサーバーを構成する
アクティブなHermes config.yamlのmcp_serversの下にscrapelessエントリを追加します。Hermesを起動する前に、前提条件の値を環境内の実際のキーに置き換えます。
yaml
mcp_servers:
scrapeless:
command: npx
args: ["-y", "scrapeless-mcp-server"]
env:
SCRAPELESS_KEY: "${SCRAPELESS_KEY}"
enabled: true
tools:
include:
- google_search
- scrape_markdown
- browser_create
- browser_goto
- browser_snapshot
- browser_click
- browser_get_text
- browser_close
resources: false
prompts: falsecommand、args、env、およびtoolsキーは、Hermes MCP構成リファレンスに従います。許可リストは意図的なものです。研究アシスタントに検索、読み取り可能な抽出、および制限されたブラウザループを提供し、利用可能なすべての操作を公開しません。
Scrapelessを使ってスクレイピングを開始
Scrapelessであなたのウェブスクレイピングおよびオートメーションワークフローを強化しましょう！
今日サインアップして**$5の無料クレジット**を獲得しましょう — クレジットカードは不要です。
今すぐあなたの無料クレジットをScrapeless Dashboardで受け取ってください。
接続とツール検出の確認
Hermesには、設定されたサーバーを起動し、MCPハンドシェイクを実行し、検出されたツールを一覧表示する接続テストが含まれています。
bash
hermes mcp list
hermes mcp test scrapeless確認済みの実行からは、次の概要が報告されました：
text
scrapeless node ... 8 selected enabled
Connected
Tools discovered: 242つのカウントは異なるサーフェスを表しています。「選択された8」はHermes設定に保存された許可リストです。「発見された24」は接続テスト中に返された完全なツールカタログです。ランタイムでは、許可リストはモデル用の意図されたサーフェスです。
ツール名はHermesに、サーバーとネイティブツールを特定するMCP名前空間を持って表示されます。正確な書式はHermesによって処理され、tools.include内のサーバーネイティブ名はgoogle_search、scrape_markdown、およびブラウザ操作名のままです。基盤となるプロトコル交換は、モデルコンテキストプロトコル仕様に従います。
Hermesが実行中に設定が変更された場合、セッション内で/reload-mcpを使用してください。接続テストと資格情報テストは別々です。後のウェブ呼び出しが認証できなくても、有効なスキーマに対してハンドシェイクが成功する場合があるため、実際のキーをロードした後に読み取り専用の検索を行ってください。
実際の使用方法：エージェントにプロンプトを促す
最良のプロンプトは、証拠基準と許可されたツールのパスを説明し、脆弱なクリックシーケンスではありません。
コピペ可能なプロンプト
名前のプロジェクトの現在のインストール要件をウェブで検索してください。公式文書の結果を開き、関連セクションをMarkdownとして抽出し、短いチェックリストを返してください。ソースURLを引用し、文書化された事実と推論を区別してください。記述可能なツールを使用しないでください。
このプロンプトは、チェック可能な結果を保持しながらHermesにツールを選択する余地を与えます。検索は公式ページを発見し、Markdown抽出は読みやすい証拠を提供します。回答にはURLが含まれ、推論にはラベルが付けられます。
ブラウザを活用したプロンプト
公開製品ページを開き、インタラクティブなページ構造を調査し、表示されているプラン名とその単位を報告してください。サインインせず、フォームを送信せず、購入コントロールをクリックしないでください。最終ページのURLを含め、テーブルをサポートするために必要な最小限のテキストのみを引用してください。
このバージョンは、重要なアクションの周りにネガティブな制約を設定します。許可リストも役立ちます：選択されたブラウザ操作がそれを表現できない限り、フォーム送信ツールは表示されず、プロンプトはそのアクションを禁止します。
Scrapeless MCPツールサーフェス
確認されたサーバービルドは、4つの有用なファミリーにグループ化された24のツールを返しました：
| ファミリー | 例 | Hermesでの使用 |
|---|---|---|
| 検索 | google_search, google_trends |
現在のソースとトレンドデータを発見する |
| 抽出 | scrape_markdown, scrape_html, scrape_screenshot |
公開URLをモデルが読み取れる証拠に変換する |
| クロール | crawl_start, crawl_result, crawl_cancel |
定義された公開サイトの範囲を横断する |
| ブラウザ | セッション、ナビゲーション、スナップショット、入力、読み取り、閉じるツール | レンダリングやインタラクションが必要なページを操作する |
習慣的に完全なカタログを開示しないでください。報告作成エージェントは検索とMarkdown抽出のみが必要な場合があります。ブラウザタスクにはセッションライフサイクルとページアクションが必要です。それらの権限セットが物質的に異なる場合は、Hermesのプロファイルを別々に保つか、サーバーエントリを分けてください。
Scrapeless AIエージェントサーフェスは製品コンテキストを提供し、価格設定は期待されるウェブ操作をアカウントプランにマッピングするのを助けます。
返されるもの
MCPツールの結果は、隠されたブラウザの状態ではなく、構造化されたメッセージとして残ります。検索は結果記録を返すことができ、抽出はMarkdownを返すことができ、ブラウザスナップショットは次のモデル決定に適した要素説明を返すことができます。その後、Hermesは選択された結果をそのタスクコンテキストに配置します。
この分離は診断を改善します。「サーバーが起動に失敗した」、「ツール検出に失敗した」、「資格情報が拒否された」、「ページが有用なコンテンツを返さなかった」は異なるイベントです。ハーネスは、すべての失敗をあいまいなモデルの謝罪に変える代わりに、正しいものを報告できます。
結論
HermesエージェントとScrapeless MCPは、クリーンな境界でフィットします：Hermesは推論とオーケストレーションを所有し、MCPサーバーは型付きWeb操作を所有します。確認されたパスは、インストール、1つのstdioサーバーの構成、狭い許可リストの適用、発見のテスト、および読み取り専用の資格情報ゲート付き呼び出しを行うことです。
Webに対応したHermesエージェントを構築する準備はできていますか？
コミュニティに参加して無料プランを獲得し、エージェント研究ワークフローを構築している開発者とつながりましょう：Discord · Telegram。
app.scrapeless.comでサインアップし、Hermesを最小限の有用なWebツール表面に接続します。
FAQ
Q: HermesエージェントはMCPサーバーをサポートしていますか？
はい。HermesエージェントはローカルstdioおよびリモートHTTP MCPサーバーをサポートし、起動時にそれらのツールを発見し、サーバーごとに見えるツールをフィルタリングできます。
Q: Scrapeless stdioサーバーはどの環境変数を使用しますか？
文書化されたstdio設定はSCRAPELESS_KEYを使用します。これをサーバー環境に配置し、値をプロンプトやコミットされた設定ファイルから外してください。
Q: 接続テストが許可リストよりも多くのツールを表示するのはなぜですか？
接続テストはサーバーが発見したカタログを報告し、許可リストはモデルに意図されたサブセットを定義します。確認されたセットアップでは、サーバーが24のツールスキーマを返し、設定が8を選択しました。
Q: 成功したMCP接続はAPIキーが機能することを証明しますか？
いいえ。成功したハンドシェイクは、Hermesがサーバーを起動し、そのスキーマを発見したことを証明します。実際のキーを読み込んだ後に読み取り専用のWeb操作を実行して、サービス認証を確認します。
Q: すべてのScrapeless MCPツールを有効にするべきですか？
いいえ。エージェントの仕事に必要な操作のみを有効にします。小さなツールセットは選択のあいまいさを減らし、誤った操作の影響を制限します。
Q: HermesはAIエージェントフレームワークなしでScrapelessを使用できますか？
Hermesはこのセットアップにおけるエージェントの実行環境です。それは直接Scrapeless MCPサーバーに接続するため、追加のエージェントフレームワークは必要ありません。
Q: 設定でstdioの代わりにHTTPを使用できますか？
はい。両方の製品はHTTP対応のMCP接続を文書化しています。stdioはローカルの子プロセスには便利ですが、リモートHTTPはサーバーライフサイクルと資格情報が中央で管理される際に便利です。
Q: MCPはウェブサイトのアクセスルールを上書きしますか？
いいえ。MCPはクライアントとツールサーバーが通信する方法を定義します。エージェントはターゲットにアクセスするための権限が必要であり、公開または承認されたデータを使用し、適用される条件や法律に従う必要があります。
Scrapelessでは、適用される法律、規制、およびWebサイトのプライバシーポリシーを厳密に遵守しながら、公開されているデータのみにアクセスします。 このブログのコンテンツは、デモンストレーションのみを目的としており、違法または侵害の活動は含まれません。 このブログまたはサードパーティのリンクからの情報の使用に対するすべての責任を保証せず、放棄します。 スクレイピング活動に従事する前に、法律顧問に相談し、ターゲットウェブサイトの利用規約を確認するか、必要な許可を取得してください。
