Remoote Remote Jobs MCP

Remoote Remote Jobs MCP

これは Remoote Remote Jobs MCP の公開メタデータおよびドキュメント用リポジトリです。

• ウェブサイトとドキュメント：https://remoote.app/agents
• MCP エンドポイント：https://api.remoote.app/remoote/agents/mcp
• トークンの設定：https://remoote.app/agents/connect

Remoote MCP を使うと、エージェントは現在募集中のリモート求人を検索したり、求人の詳細を読んだり、給与統計を比較したり、人気の職種を表示したり、求人アラートを作成したり、ユーザー確認後に応募ページへリダイレクトしたりできます。求人ページをスクレイピングしたり、雇用主の応募先リンクをそのまま公開したりせずに求人データを必要とするエージェントの開発者向けです。

ツール

ツール	アクセス	内容
search_jobs	公開またはトークン	職種名、求人情報内の幅広いキーワード、スキル、勤務地フィルター、経験レベル、雇用形態、給与の公開状況で、募集中の Remoote の求人を検索します。
get_job	公開またはトークン	給与情報、勤務地の条件、スキル、抜粋、Remoote の求人 URL など、募集中の求人 1 件の公開詳細を返します。
get_salary_stats	公開またはトークン	正規化された報酬データが十分にある場合、一致する求人の給与統計を返します。
get_top_jobs	公開またはトークン	現在人気のリモート求人を、上限付きのリストで返します。
create_apply_intent	トークン必須	エージェントが確認を求めた後、認証済みユーザー向けの Remoote 応募リダイレクトを作成します。
create_alert	トークン必須	認証済みユーザー向けに、毎日または毎週の Remoote 求人アラートを作成します。

求人検索フィールド

ユーザーが希望する職種または求人タイトル（例：backend engineer）には role_title を使用します。求人タイトルのみを検索対象とします。python や postgresql のように、求人情報のほかの箇所に記載されている可能性のある幅広いキーワードには query を使用します。この 2 つのフィールドは組み合わせて使えます。

MCP の求人検索では、正確な件数の計算にコストがかかるため、total_available: null が返されることがあります。result_count には、常に現在のレスポンスで返された求人の件数が設定されます。

公開アクセスとトークン認証済みアクセスの動作

公開アクセスは、トークンなしで求人の検索や読み取り専用の調査に利用できます。件数に上限があり、公開 Remoote フィールド、正規の Remoote URL、安全な次のアクションが返されます。

トークン認証済みアクセスでは、ユーザーが作成したベアラートークンを使用します。アラートや応募インテントなど、ユーザーアカウントに紐づくワークフローが必要な場合にのみ使用してください。https://remoote.app/agents/connect でトークンを作成または取り消してから、次のように渡します。

Authorization: Bearer rma_...

ワークフローで必要なスコープのみを許可してください。

応募時の安全性

公開レスポンスには、雇用主の応募先 URL はそのまま含まれません。ユーザーを Remoote の求人ページに案内します。

create_apply_intent も雇用主の URL ではなく、Remoote へのリダイレクトを返します。リダイレクトを開くと応募リダイレクトまたは利用資格の確認としてカウントされる可能性があるため、開く前にエージェントはユーザーに確認を求めてください。

curl の簡単な例

すべての例では、JSON-RPC 経由でリモート MCP エンドポイントを直接呼び出します。

ツールの一覧表示

curl -sS \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  https://api.remoote.app/remoote/agents/mcp

期待される結果：tools に search_jobs、get_job、get_salary_stats、get_top_jobs、create_apply_intent、create_alert が含まれます。

公開求人の検索

curl -sS \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_jobs","arguments":{"role_title":"backend engineer","query":"python","limit":3,"salary_required":false}}}' \
  https://api.remoote.app/remoote/agents/mcp

期待される結果：structuredContent.status が ok になり、result_count が返された求人の件数と一致します。また、各求人からは雇用主の応募先 URL がそのまま公開されるのではなく、Remoote にリンクします。total_available は null になることがあります。

トークンを使ったアラートの作成

export REMOOTE_AGENT_TOKEN='rma_...'

curl -sS \
  -H 'content-type: application/json' \
  -H "Authorization: Bearer $REMOOTE_AGENT_TOKEN" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"create_alert","arguments":{"name":"Python remote jobs","criteria":{"query":"python","salary_required":true},"frequency":"daily","limit":10}}}' \
  https://api.remoote.app/remoote/agents/mcp

例では rma_... のようなプレースホルダーを使用してください。実際のトークンをドキュメント、ログ、プロンプトに記載しないでください。

その他の例

• curl と MCP Inspector でエンドポイントを確認する
• 求人検索エージェント向けのプロンプト例

レジストリメタデータ

server.json は、MCP のディレクトリやレジストリ向けに用意されています。リポジトリ URL は、将来公開される予定の GitHub 上の場所を指しています：https://github.com/asmisha/remoote-mcp。