Max Nardit
AI エージェント

Share2Agent で Web ページを Windsurf に送る方法

ドキュメント、API リファレンス、エラーページを Windsurf の AI アシスタントへ直接送ります。Share2Agent はあらゆる Web ページからクリーンなテキストを抽出し、Windsurf が読み込める Markdown ファイルとして保存します。

前提条件

  • Codeium の Windsurf IDE がインストール済み
  • Share2Agent Chrome 拡張機能がインストール済み
  • Python 3.10+ と PyYAML (pip install pyyaml)

ステップ 1: レシーバーをセットアップする

Share2Agent は軽量な Webhook レシーバーを使ってページを Markdown ファイルとして保存します。Windsurf はそれらのファイルをコンテキストとして読み取ります。

bash
git clone https://github.com/mnardit/share2agent.git
cd share2agent/examples/receiver
pip install pyyaml

ステップ 2: 保存ディレクトリを設定する

PAGES_DIR をプロジェクト内の場所 (または Windsurf がアクセスできる共有ディレクトリ) に向けます。

bash
export PAGES_DIR=~/my-project/references
python3 -u receiver.py

レシーバーはポート 9876 で起動し、共有された各ページを URL、タイトル、タイムスタンプ、追加したコメントを含む YAML フロントマター付きの .md ファイルとして保存します。

スクリプトを編集せずに PORT と PAGES_DIR を環境変数として設定することもできます。

ステップ 3: Share2Agent を設定する

  1. Chrome で Share2Agent 拡張機能のアイコンをクリックします。
  2. Settings を開きます。
  3. Webhook URL を http://localhost:9876 に設定します。
  4. 保存します。

レシーバーをリモートマシンや Tailscale で実行する場合は、localhost をマシンのホスト名に置き換えてください。

ステップ 4: ページを共有する

  1. 任意のドキュメントページ、Stack Overflow の回答、API リファレンスに移動します。
  2. Share2Agent のアイコンをクリックします。
  3. 任意で「この API を認証に使う」のような コメント を追加します。
  4. Share をクリックします。

レシーバーは設定したディレクトリにページを保存します。例:

~/my-project/references/2026-03-28-1430-nextjs-middleware-docs.md

ステップ 5: Windsurf で参照する

Windsurf の AI チャット (Cascade) を開いて、保存したファイルを参照します。

  • プロンプトに直接ファイルパスを書く
  • もしくは references ディレクトリをワークスペースに追加し、Cascade に自動的にインデックスさせる

プロンプトの例:

references/2026-03-28-1430-nextjs-middleware-docs.md を見て、
そこで説明されているパターンを使ってミドルウェアベースの認証を
実装するのを手伝ってください。

Windsurf は Markdown のコンテンツを回答のコンテキストとして取り込みます。

バックグラウンドサービスとして実行する

ターミナルウィンドウなしでレシーバーを動かし続けるには:

bash
# systemd ユーザーサービス
mkdir -p ~/.config/systemd/user
cat > ~/.config/systemd/user/share2agent-receiver.service << 'EOF'
[Unit]
Description=Share2Agent Webhook Receiver
 
[Service]
Environment=PAGES_DIR=%h/my-project/references
ExecStart=/usr/bin/python3 -u /path/to/receiver.py
Restart=on-failure
 
[Install]
WantedBy=default.target
EOF
 
systemctl --user daemon-reload
systemctl --user enable --now share2agent-receiver

次のステップ

  • プロジェクトごとに整理: ワークスペースごとに PAGES_DIR を変えた複数のレシーバーを動かします。
  • クリーンアップスクリプトを追加: 7 日以上経過した参照ファイルを削除して、ワークスペースを整理して保ちます。
  • Windsurf ルールと組み合わせる: .windsurfrules ファイルを作って、Cascade に対し、回答前に常に references/ ディレクトリを関連コンテキストとして確認するよう指示します。
Share2Agent で Web ページを Windsurf に送る