PeoplePerHour by Cotlet

PeoplePerHour API とセルフホスト型 MCP サーバー

ご自身のコンピューター上で、Python とご自身の Google Chrome のセッションを使って実行する PeoplePerHour API と PeoplePerHour MCP サーバーです。Cotlet の本番環境で使用しているものと同じ 17 個の PeoplePerHour ツールを利用できます。公開中のプロジェクトを検索して詳細な募集内容を確認する、フリーランサーや Offers を検索して最近のレビュー付きプロフィールを読む、プロジェクトのウォッチリストや保存済み検索を管理してメールアラートを受け取る、カテゴリごとの予算の中央値を確認する、自分が投稿したプロジェクトや通知、WorkStreams を読むことができます。

PeoplePerHour には公開 API も公式 MCP サーバーもありません。このリポジトリでは、その両方を利用できます。

• stdio または HTTP 経由で Claude Code、Claude Desktop、Cursor、Codex、その他の MCP クライアントから利用できる MCP サーバー。セットアップ
• http://127.0.0.1:8787/api/v1/peopleperhour にある REST API。OpenAPI ドキュメントは /docs で確認できます。セットアップ
• Python：call("search_projects", query="web design") と、すぐに使える 9 個のスクリプトを examples/ に用意しています。

13 個のツールは読み取り専用です。残り 4 個のツールで変更できるのは、ご自身のウォッチリストと保存済み検索だけです。ここから提案やメッセージを送信したり、プロジェクトを投稿したり、Offer を購入したり、支払いをしたりすることはありません。また、Proposal クレジットも消費しません。

自分で実行したい技術者向けです。非商用利用に限ります（ライセンス）。サーバー上で 24 時間稼働させたい場合、PeoplePerHour のサイト変更後も動作するようにしたい場合、チームやビジネスで利用したい場合は、cotlet.dev のホスト版をご利用ください。

git clone https://github.com/cotletdev/peopleperhour-api-mcp-server.git && cd peopleperhour-api-mcp-server
python3 -m venv .venv && . .venv/bin/activate && pip install -e .
peopleperhour-mcp connect                          # reads your PeoplePerHour session from Chrome
peopleperhour-mcp call search_projects query="web design" limit=5
claude mcp add peopleperhour -- "$PWD/.venv/bin/peopleperhour-mcp" mcp

目次

• 仕組み
• 必要条件
• インストール
• Chrome を接続する
• MCP サーバー
• REST API
• Python とサンプルスクリプト
• 17 個のツールすべて
• 設定
• セキュリティと PeoplePerHour アカウント
• エラー
• セルフホストとホスト版
• よくある質問
• ライセンス

仕組み

AI agent (MCP) / script (REST, Python) ──▶ peopleperhour-mcp on your computer ──your cookies──▶ www.peopleperhour.com
                                                    ▲
                      peopleperhour-mcp connect ────┘ reads them once from your Chrome (DevTools Protocol)

1. いつもどおり、ご自身の Chrome で PeoplePerHour にサインインします。ログイン状態を保持するにチェックを入れてください。
2. peopleperhour-mcp connect は Chrome DevTools Protocol を通じてその Chrome に接続し、peopleperhour.com の Cookie を読み取って ~/.config/peopleperhour-api-mcp/session.json に保存します。このファイルを読み取れるのはご自身のユーザーだけです。パスワードを参照したり保存したりすることはありません。
3. 各ツールの呼び出しでは、PeoplePerHour のサイト自体が使用する JSON API（www.peopleperhour.com/v2/...）に対し、curl_cffi を使って Cookie 付きのリクエストを送信します。curl_cffi は Chrome の TLS フィンガープリントを再現します。ヘッドレスブラウザーは実行されません。

セッションは api Cookie に保存され、ログイン状態を保持する設定でサインインしてから約 100 日間有効です。PeoplePerHour からサインアウトされた場合、Chrome が開いていてリモートデバッグが有効であれば、サーバーは Chrome から Cookie を再取得します。

必要条件

• Python 3.11 以降。
• PeoplePerHour にサインイン済みの Google Chrome 144 以降。デバッグポートが有効であれば、任意の Chrome または Chromium を使用できます（デバッグポートを使う Chrome の場合）。
• macOS、Linux、または Windows。
• 任意の PeoplePerHour アカウント。17 個すべてのツールを使うには、無料のバイヤーアカウントで十分です。

インストール

git clone https://github.com/cotletdev/peopleperhour-api-mcp-server.git
cd peopleperhour-api-mcp-server
python3 -m venv .venv
. .venv/bin/activate              # Windows: .venv\Scripts\activate
pip install -e .
peopleperhour-mcp --version

uv を使う場合：uv venv && uv pip install -e . を実行し、その後 uv run peopleperhour-mcp ... を実行します。

AI エージェント（Claude Code、Codex、Cursor）を使って設定しますか？このフォルダーで開き、リポジトリの設定を依頼してください。AGENTS.md にすべての手順が記載されており、Chrome での操作が必要なときだけ確認を求めます。

更新するには、git pull && pip install -e . を実行します。ホストされている PeoplePerHour ツールへの変更はすべて、このリポジトリにコピーします。

Chrome を接続する

オプション A：普段使っている Chrome（推奨）

1. Chrome で chrome://inspect/#remote-debugging を開き、リモートデバッグをオンにします。これで、Chrome はこのコンピューター上のプログラムからの DevTools 接続を受け入れ、接続ごとに確認を求めるようになります。

2. peopleperhour.com にサインインしていることを確認します。

3. 次を実行します。

   peopleperhour-mcp connect
   

4. Chrome が接続を許可するか確認します。許可をクリックします。

Saved 9 PeoplePerHour cookies to /Users/you/.config/peopleperhour-api-mcp/session.json
Signed in to PeoplePerHour as Maya Reed ([email protected])

その後、リモートデバッグをオフに戻してもかまいません。PeoplePerHour からサインアウトした後、サーバーが新しいセッションを自動的に取得できるようにするには、オンのままにしてください。

connect は、Chrome のデフォルトのプロファイルフォルダーにある DevToolsActivePort ファイルを探します。Chrome Beta、Canary、またはカスタムのプロファイルフォルダーを使う場合は、--profile-dir "<folder>" を渡してください。

オプション B：デバッグポートを使う Chrome

Chrome はデフォルトのプロファイルではデバッグポートを開かないため、別のプロファイルを起動し、そこで一度 PeoplePerHour にサインインしてから接続します。

# macOS
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-pph"
# Linux
google-chrome --remote-debugging-port=9222 --user-data-dir="$HOME/.chrome-pph"
# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%USERPROFILE%\.chrome-pph"

peopleperhour-mcp connect --cdp http://127.0.0.1:9222

--cdp には ws:// DevTools URL も指定できます。たとえば、SSH トンネル経由で接続した別のマシン上の Chrome の URL を指定できます。

オプション C：Cookie を手動で貼り付ける

Chrome を使わないサーバーの場合：Chrome で peopleperhour.com の DevTools を開き、Application > Cookies > https://www.peopleperhour.com に移動して、api の値をコピーし、次を実行します。

peopleperhour-mcp connect --token          # paste it, input is hidden
# or, without a session file:
export PEOPLEPERHOUR_AUTH_TOKEN=...

貼り付けたトークンは自動更新されません。PeoplePerHour からサインアウトしたら、新しいトークンを貼り付けてください。

セッションはいつでも次のように確認できます。

peopleperhour-mcp status

MCP サーバー

MCP サーバーには、入力スキーマとエージェント向けの説明が付いた 17 個のツールがすべて表示されます。読み取りツール 13 個は読み取り専用としてマークされており、--read-only を指定すると、ウォッチリストと保存済み検索を変更する 4 個のツールが非表示になります。

Claude Code

claude mcp add peopleperhour -- /path/to/peopleperhour-api-mcp-server/.venv/bin/peopleperhour-mcp mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "peopleperhour": {
      "command": "/path/to/peopleperhour-api-mcp-server/.venv/bin/peopleperhour-mcp",
      "args": ["mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json に、Claude Desktop と同じブロックを記述します。すぐに使えるコピーは mcp.json にあります。

Codex

~/.codex/config.toml：

[mcp_servers.peopleperhour]
command = "/path/to/peopleperhour-api-mcp-server/.venv/bin/peopleperhour-mcp"
args = ["mcp"]

HTTP 経由

peopleperhour-mcp serve は、URL を指定するクライアント向けに、http://127.0.0.1:8787/mcp でストリーミング可能な HTTP 経由の MCP も提供します。

peopleperhour-mcp serve
claude mcp add --transport http peopleperhour http://127.0.0.1:8787/mcp

続いて、次のようなことをエージェントに依頼できます。

PeoplePerHour で昨日以降に投稿されたウェブデザイン案件を確認し、£200 未満、または提案数が 15 件を超える案件を除外してください。残りの案件の概要を読み、候補を 5 件挙げてください。

案件 4527712 の概要を読み、購入者が添付したファイルを開いて、納品が必要なものと回答が必要な質問を一覧にし、貼り付けて使える提案文を作成してください。

案件 4527712 はまだ募集中ですか？現在の提案数はいくつですか？

時給 £10〜£30 で評価が 80％以上のロゴデザイナーを探し、上位 5 名のプロフィールと最近のレビューを読んで、連絡すべき 3 名を教えてください。

「Urgent design」という名前で、緊急の固定価格制デザイン案件の検索を保存し、毎日メールを受け取れるようにしてください。

REST API

peopleperhour-mcp serve                    # http://127.0.0.1:8787, MCP at /mcp, docs at /docs

各ツールには /api/v1/peopleperhour 配下に専用のルートがあり、cotlet.dev のホステッド API と同じパスを使用するため、一方に対して書いたコードはもう一方でも動作します。パスの各部分とクエリ文字列が引数になります。

curl 'http://127.0.0.1:8787/api/v1/peopleperhour/projects/search?query=web%20design&since=2026-10-21T07:00:00Z&limit=20'
curl 'http://127.0.0.1:8787/api/v1/peopleperhour/projects/4527712'
curl 'http://127.0.0.1:8787/api/v1/peopleperhour/freelancers/search?query=logo%20design&min_rating=80'
curl -X PUT 'http://127.0.0.1:8787/api/v1/peopleperhour/projects/4527712/watch'

ツール名を指定し、本文を引数として呼び出します。

curl -X POST http://127.0.0.1:8787/api/v1/peopleperhour/tools/search_projects -d '{"category": "design", "limit": 10}'

• GET /api/v1/peopleperhour/tools：ルート、入力スキーマ、回答例を含むすべてのツールを表示します。
• GET /docs：対話型の OpenAPI ドキュメントです。GET /openapi.json はスキーマで、n8n、Postman、または生成したクライアントで使用できます。
• 回答は JSON 形式です。リストを返すツールは next_cursor を返します。次のページを取得するには、それを cursor として渡してください。

サーバーは 127.0.0.1 のみでリッスンします。別のデバイスからアクセスするにはトークンを設定してください。その場合、すべてのリクエストに Authorization: Bearer <token> が必要です。

PEOPLEPERHOUR_MCP_TOKEN=$(openssl rand -hex 24) peopleperhour-mcp serve --host 0.0.0.0

Python とサンプルスクリプト

サーバーを使わずに、Python から直接利用できます。

from peopleperhour_api_mcp import call
from peopleperhour_api_mcp.scripting import paginate, write_rows

new = list(paginate("search_projects", {"query": "logo", "since": "2026-10-21T00:00:00Z"}, "projects"))
write_rows(new, "projects.csv")
brief = call("get_project", project_id=new[0]["project_id"])["brief"]

または、シェルからツールを1つ実行します。peopleperhour-mcp call get_project project_id=4527712 のように指定するか、JSON オブジェクトを渡します。

examples/ には、インテグレーションページにある各ジョブに対応したスクリプトが用意されています。各スクリプトは --help を受け付けます。また、リストを返すスクリプトでは --out file.csv または --out file.json を指定できます。

スクリプト	機能
find_new_projects.py	過去 N 時間以内の、1つ以上のキーワードに一致する新規プロジェクトをまとめ、--min-budget（または --hourly-rate）と --max-proposals で絞り込んだうえで、残った各プロジェクトの詳細な概要、質問、ファイルを取得します。
read_project_brief.py	提案を書く前に、1つのプロジェクトについて、概要、添付ファイル、購入者からの質問、提案、期限、80％の最低価格を確認します。
watch_urgent_projects.py	提案数が N 件未満の、指定カテゴリの緊急プロジェクトを取得します。--state を使うと前回の実行状態を保存でき、1時間ごとの cron ジョブに利用できます。
check_project_open.py	プロジェクトがまだ募集中かどうかと、それぞれの現在の提案数を確認します。
shortlist_freelancers.py	スキルでフリーランサーを検索し、料金帯と評価で絞り込んで、各プロフィールの統計情報と最新レビューの平均を表示します。
compare_offers.py	仕事に関する上位の Offer を並べて比較します。価格、納期（日数）、販売実績、追加オプション、販売者があなたに求めるものを確認できます。
save_project_alert.py	フィルター付きのプロジェクト検索を保存し、毎日または即時のメール通知を設定して、保存済みの検索を一覧表示します。
buyer_daily_digest.py	購入者向けに、募集中のプロジェクトと提案数、未読の通知、未読メッセージのある WorkStream を表示します。
median_budgets.py	指定したカテゴリについて、フリーランサーのレベル別に固定料金と時間単価の中央値を、GBP、USD、または EUR で表示します。

python examples/find_new_projects.py --query "web design" --query webflow --hours 24 --min-budget 200 --max-proposals 15
python examples/read_project_brief.py 4527712
python examples/shortlist_freelancers.py "logo design" --hourly-rate 10-30 --min-rating 80
python examples/median_budgets.py translation --currency USD

スケジュール実行には、自分のコンピューターが起動している間であれば cron を利用できます。例：0 * * * * cd ~/peopleperhour-api-mcp-server && .venv/bin/python examples/watch_urgent_projects.py --category design --state urgent.json。

予算は PeoplePerHour が表示する購入者の通貨（GBP、EUR、USD）で比較されます。そのため、最低額を 200 に設定すると、購入者が選択した通貨の 200 を意味します。

17 個のツールすべて

peopleperhour-mcp tools を実行するとこの一覧が表示され、peopleperhour-mcp tools --json を実行すると入力スキーマも表示されます。時刻は UTC です。

プロジェクト

ツール	アクセス	REST ルート	機能
search_projects	読み取り	GET /projects/search	購入者が投稿した募集中のプロジェクトを、新しい順に表示します。予算、カテゴリ、提案数、概要の冒頭を確認できます。
get_project	読み取り	GET /projects/{project_id}	予算、添付ファイル、面談の質問、購入者、提案数を含む、1つのプロジェクトの詳細な概要を取得します。
list_my_projects	読み取り	GET /projects/mine	このアカウントが購入者として投稿したプロジェクトを、ステータス、予算、提案数とともに表示します。

ウォッチリスト

ツール	アクセス	REST ルート	機能
watch_project	書き込み	PUT /projects/{project_id}/watch	後で確認できるよう、このアカウントのウォッチリスト（Favourite Jobs）にプロジェクトを追加します。
unwatch_project	書き込み	DELETE /projects/{project_id}/watch	このアカウントのウォッチリストからプロジェクトを削除します。
list_watchlist	読み取り	GET /projects/watched	このアカウントのウォッチリスト（Favourite Jobs）にある募集中のプロジェクトを、予算と提案数とともに表示します。

保存済み検索

ツール	アクセス	REST ルート	機能
list_saved_searches	読み取り	GET /saved-searches	このアカウントで保存したプロジェクト検索と、そのフィルターおよびメール通知の設定を表示します。
save_search	書き込み	POST /saved-searches	メール通知を設定してプロジェクト検索を保存するか、既存の検索の名前またはメール通知の頻度を変更します。
delete_saved_search	書き込み	DELETE /saved-searches/{saved_search_id}	このアカウントで保存したプロジェクト検索と、そのメール通知を削除します。

フリーランサー

ツール	アクセス	REST ルート	機能
search_freelancers	読み取り	GET /freelancers/search	スキルまたはキーワードでフリーランサーを検索します。料金、評価、レビュー、完了したプロジェクト、スキルを確認できます。
get_freelancer	読み取り	GET /freelancers/{freelancer_id}	フリーランサーの公開プロフィールを表示します。料金、統計、スキル、ポートフォリオ、ページに掲載されている最新のレビューを確認できます。

オファー

ツール	アクセス	REST ルート	機能
search_offers	読み取り	GET /offers/search	フリーランサーが販売する固定価格のオファーを、キーワードまたは価格で検索します。販売数、評価、販売者を確認できます。
get_offer	読み取り	GET /offers/{offer_id}	1件のオファーについて、説明全文、販売者が依頼者に求める内容、価格、追加オプション、画像を表示します。

アカウント、通知、WorkStreams

ツール	アクセス	REST ルート	機能
get_account	読み取り	GET /account	サインイン中のPeoplePerHourアカウント情報を表示します。名前、アカウント種別、購入者統計、未読メッセージ数、お気に入り数を確認できます。
list_notifications	読み取り	GET /notifications	このアカウントの最新通知（提案、メッセージ、プロジェクトの更新）と未読件数を表示します。
list_workstreams	読み取り	GET /workstreams	このアカウントのWorkStreams（採用したフリーランサーとの会話）を、最新メッセージとともに表示します。

カテゴリー

ツール	アクセス	REST ルート	機能
list_categories	読み取り	GET /categories	10種類のプロジェクトカテゴリーと、そのサブカテゴリー、およびフリーランサーのレベルごとの標準予算を表示します。

sinceを指定するとポーリングの負荷を抑えられます。エージェントは前回確認した時刻を渡し、それ以降に届いたものだけを読み取ります。sinceを指定した1回の呼び出しでスキャンするのは、最新のプロジェクト最大200件です。そのため、ページにlimit未満の件数しかなくても、next_cursorが返されることがあります。

予算、料金、価格はPeoplePerHourから提供される形式のまま返されます。プロジェクトは購入者の通貨で、フリーランサーの料金、オファー、予算の中央値は、アカウントの通貨または選択した通貨で表示されます。

このバージョンでは対応していません：フリーランサー側の機能（提案、販売者プロフィール、自分のオファー）、プロジェクトの投稿や編集、WorkStreamsでのメッセージ送信、提案の承諾、支払い、請求書、提案クレジット。

意図的に実装していないもの：PeoplePerHourへのサインイン、メールアドレス、パスワード、設定、および金銭が移動するすべての機能（提案クレジット、サブスクリプション、支払い）。すべてのリクエストはガードを通過し、PeoplePerHourのこれらのパスへの変更は拒否されます。

設定

変数	デフォルト	説明
PEOPLEPERHOUR_MCP_HOME	~/.config/peopleperhour-api-mcp	session.json のフォルダーです。
PEOPLEPERHOUR_AUTH_TOKEN		peopleperhour-mcp connect の代わりに使用する PeoplePerHour の api Cookie です。
PEOPLEPERHOUR_PROXY		PeoplePerHour へのすべてのリクエストに使用するプロキシです。例：http://user:pass@host:port。
PEOPLEPERHOUR_MCP_READ_ONLY		1 にすると、PeoplePerHour に変更を加える4つのツール（ウォッチリストと保存済み検索）が非表示になり、使用できなくなります（--read-only と同じです）。
PEOPLEPERHOUR_MCP_TOKEN		serve に必要なベアラートークンです。127.0.0.1 以外でリッスンする場合に必要です。
PEOPLEPERHOUR_MCP_HOST、PEOPLEPERHOUR_MCP_PORT	127.0.0.1、8787	serve のアドレスです。

セキュリティとPeoplePerHourアカウント

• パスワードがこのコードに渡ることはありません。 読み取るのはCookieのみで、対象はpeopleperhour.comのCookieだけです。
• セッションファイルはご自身で管理してください。 session.json はモード0600で作成されます。このファイルを持つ人は誰でも、PeoplePerHourであなたになりすまして操作できます。gitや共有フォルダーに置かないでください。
• デフォルトではローカルで動作します。 serve は 127.0.0.1 にバインドし、PEOPLEPERHOUR_MCP_TOKEN が設定されていない場合は別のアドレスを拒否します。
• peopleperhour.comのみが対象です。 peopleperhour.com以外へのリクエストやリダイレクトは拒否されます。添付ファイルのリンク先はPeoplePerHourのファイルホストです。サーバーはリンク先のファイルを返しますが、ダウンロードはしません。
• ご自身のリストのみが対象です。 読み取りツールは13個です。書き込みツールは4個で、ウォッチリストと保存済み検索のみを変更します。提案、メッセージ、Offerの購入など、ほかの操作は行いません。ウォッチ中のプロジェクトでは、あなたがウォッチャーとして表示されるため、追跡しなくなったものはウォッチ解除してください。
• 人間らしいペースを保ってください。 1時間ごとのcronジョブは問題ありません。1分間に何百回も呼び出すのは人間の閲覧ペースではありません。アカウントで実行する処理については、ご自身が責任を負います。

エラー

REST APIは {"error": "<code>", "message": "..."} を返します。MCPサーバーは、同じコードとメッセージをツールエラーとして返します。

ステータス	コード	対処方法
401	auth_required, auth_expired	セッションがないか、PeoplePerHourからサインアウトされています。ChromeでPeoplePerHourにサインインしてから、peopleperhour-mcp connect を実行してください。
403	target_blocked	PeoplePerHourがリクエストを拒否したか、ボットチェックが表示されました。Chromeでpeopleperhour.comを一度開いてから、再試行してください。
409	captcha_required	PeoplePerHourからCAPTCHAを求められています。Chromeで解決してください。
422	invalid_input	引数が不足しているか、正しくありません。メッセージに該当する引数が示されます。
429	rate_limited	PeoplePerHourがアカウントを制限しています。数分待ってください。
502	target_error	該当するプロジェクト、フリーランサー、Offer、保存済み検索が存在しない、非公開または削除済みである、PeoplePerHourが拒否したフィルター（理由はメッセージに記載されています）、またはPeoplePerHourがエラーを返したか、サイトが変更された可能性があります。ツールの最新版を取得するには git pull を実行するか、issueを作成してください。

セルフホスト版とホスト版

	このリポジトリ	Cotlet、ホスト版
ツール	同じ17個	同じ17個
実行場所	コンピューターの電源が入っている間、ご自身のコンピューター上	クラウド上、24時間365日
PeoplePerHourのセッション	ご自身のChrome、Cookieはローカルファイルに保存	EU内のご自身のCloud Browser、プロファイルはAES-256-GCMで暗号化
PeoplePerHourのサイト変更時	修正後に git pull を一度実行	こちらで修正し、すべてのツールを毎日テスト
対応環境	お使いのマシン上のMCPクライアント、ローカルスクリプト	Claude.aiとChatGPTのコネクター、n8n、Make、Zapier、あらゆるHTTPクライアント
利用対象	非商用利用の個人	チーム、企業、エージェンシー
料金	無料	2,000クレジット付きの7日間無料トライアル（カード不要）。その後は5,000クレジットで29ドルからの買い切りパック

ホスト版では、成功した呼び出しは20～30クレジット（ほとんどのツールでは25クレジット）を使用し、失敗した呼び出しは無料です。Cloud Browserでエージェント向けアプリが有効になっている間は、1日に50クレジットを使用します。料金の詳細。

FAQ

PeoplePerHour に公式 API はありますか？ いいえ。PeoplePerHour には公開 API、開発者向けドキュメント、Webhook がありません（2026 年 10 月 12 日に確認）。組み込みのアラート機能は Saved Searches のみです。Jobs ページで最大 10 件の検索を保存でき、新しい検索結果があれば即時または 1 日 1 回、メールで通知されます。PeoplePerHour には、コードから呼び出せるものはありません。ここでは save_search と list_saved_searches で検索を管理します。詳細：cotlet.dev/integrations/peopleperhour-api-mcp-server。

Claude、ChatGPT、または Cursor 用の PeoplePerHour MCP サーバーはありますか？ はい。このサーバーはお使いのマシンで実行します。Claude Code、Claude Desktop、Cursor、Codex では peopleperhour-mcp mcp を使用します。ChatGPT と Claude.ai のコネクターには公開 HTTPS URL が必要です。ホスト版の PeoplePerHour MCP サーバーで利用できます。

これは PeoplePerHour のスクレイパーですか？ 求人スクレイパーに求められる情報（予算、提案数、概要を含む新規プロジェクト、フリーランサー、Offers を JSON または CSV 形式で取得できます）が、ヘッドレスブラウザーは実行しません。PeoplePerHour のサイトが呼び出すものと同じ JSON エンドポイントを、お客様自身のアカウントで呼び出します。読み取る HTML ページは、最新のレビューを確認するためのフリーランサーのプロフィールのみです。

PeoplePerHour に新しいプロジェクトが投稿されたらすぐに取得できますか？ はい。cron またはエージェントから、前回の確認時刻を since に設定して search_projects を呼び出します。watch_urgent_projects.py を使えば、その時刻を状態ファイルに保存できます。

提案を送信したり、バイヤーに返信したりできますか？ いいえ。提案、WorkStream のメッセージ、Offers の購入、請求書、Proposal クレジットには、このバージョンでは対応しておらず、クレジットも消費しません。WorkStream と通知は読み取れます。提案やメッセージの作成と送信は、PeoplePerHour 上でご自身で行ってください。

これを使って PeoplePerHour で採用できますか？ 候補者選びに役立ちます。プロフィールと最近のレビューには search_freelancers と get_freelancer、固定価格の Offers には search_offers と get_offer、バイヤーが通常支払う金額の確認には list_categories を使えます。プロジェクトの投稿、フリーランサーへの連絡、支払いは PeoplePerHour 上で行います。

有料の PeoplePerHour プランやフリーランサーアカウントが必要ですか？ いいえ。無料のバイヤーアカウントがあれば、17 個すべてのツールを利用できます。

get_project はプロジェクトのスキルを返しますか？ いいえ。PeoplePerHour のプロジェクトデータにはスキルの一覧がないためです。スキルは概要テキストに記載されており、エージェントが読み取ります。

なぜ Chrome が必要なのですか？ パスワードを使わずに PeoplePerHour のセッションを読み取るためです。Chrome はサインイン時に一度だけ使用し、呼び出しごとには使用しません。

PeoplePerHour からサインアウトされたらどうなりますか？ 呼び出しは auth_expired で失敗します。Chrome のリモートデバッグが有効であれば、次の呼び出し時にサーバーが新しい Cookie を読み取ります（Chrome から許可を求められたら「許可」をクリックしてください）。それ以外の場合は、peopleperhour-mcp connect をもう一度実行してください。

VPS や Docker で実行できますか？ 技術的には可能で、PEOPLEPERHOUR_AUTH_TOKEN を使います。ただし、その場合 PeoplePerHour にはデータセンターの IP アドレスからセッションにアクセスしているように見えるため、本人のアクセスらしさが低くなります。常時稼働させる場合は、ホスト版を使うと、ご自身の Cloud Browser 上でセッションを固定 IP アドレスから維持できます。

PeoplePerHour のアカウントが停止されることはありますか？ リクエストには Chrome のフィンガープリントが付与され、1 件ずつ送信されます。また、ツールが読み取るのは、ご自身で開ける情報のみです。プラットフォームが決して対処しないと保証することはできません。人が行う範囲に収まるよう、ポーリング頻度を抑えてください。

職場やクライアントのために使用できますか？ いいえ。ライセンスで許可されているのは非商用利用のみです。チーム、会社、またはクライアントの業務で使用する場合は、Cotlet を利用するか、[email protected] までご連絡ください。

オープンソースですか？ ソースコードは公開されていますが、ライセンスはオープンソースライセンスではありません。非商用利用のみで、業務での利用はできません。

ツールが動かない場合や、別のツールが必要な場合はどうすればよいですか？ ツール名とエラーメッセージを添えて、Issue を作成してください。

ライセンス

PolyForm Noncommercial License 1.0.0。概要は以下のとおりです。

• 許可されること： 非商用利用。ご自身の PeoplePerHour アカウントを使った個人的な目的での利用、または慈善団体、学校、公的研究機関、政府機関による利用。コードの変更、および同じライセンスでの共有。
• 許可されないこと： ご自身の事業を含む、あらゆる商用利用。クライアントの業務での利用。コードや、それを基に構築したサービスの販売または提供。

---

Cotlet（@cotletdev）がメンテナンスしています。PeoplePerHour はその所有者の商標です。このプロジェクトは非公式であり、PeoplePerHour との提携、承認、またはスポンサー関係はありません。