关于 PeoplePerHour by Cotlet
PeoplePerHour by Cotlet 是面向技术用户的自托管 Python API 和 MCP 服务,用于查找 PeoplePerHour 上的项目和自由职业者。它支持搜索、查看项目详情与个人资料、管理个人关注列表,但不会发送提案或消息。
主要功能
- 01搜索项目并查看项目简介
- 02搜索自由职业者和 Offers
- 03查看个人资料及近期评价
- 04管理关注列表和已保存搜索
- 05REST API 与 Python 脚本
适用场景
- 01按预算和提案数筛选项目
- 02根据费率和评价比较自由职业者
- 03保存搜索并设置邮件提醒
MCP 相关
通过 stdio 或流式 HTTP 向 MCP 客户端提供 PeoplePerHour 搜索和账户工具。只读工具会明确标记;只读模式可隐藏修改关注列表和已保存搜索的工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://cotlet.dev/mcp/v1/peopleperhour/connectclaude mcp add --transport http dev-cotlet-peopleperhour https://cotlet.dev/mcp/v1/peopleperhour/connect{"mcpServers":{"dev-cotlet-peopleperhour":{"type":"http","url":"https://cotlet.dev/mcp/v1/peopleperhour/connect"}}}在 Cursor 中打开{"servers":{"dev-cotlet-peopleperhour":{"type":"http","url":"https://cotlet.dev/mcp/v1/peopleperhour/connect"}}}在 VS Code 中打开{"mcpServers":{"dev-cotlet-peopleperhour":{"type":"http","url":"https://cotlet.dev/mcp/v1/peopleperhour/connect"}}}{"mcpServers":{"dev-cotlet-peopleperhour":{"serverUrl":"https://cotlet.dev/mcp/v1/peopleperhour/connect"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://cotlet.dev/mcp/v1/peopleperhour/connecthttps://cotlet.dev/mcp/v1/peopleperhour需要授权工具
详细介绍
PeoplePerHour API 和 MCP 服务,可自托管
一个 PeoplePerHour API 和 PeoplePerHour MCP 服务,使用 Python 在你自己的电脑上、通过你自己的 Google Chrome 会话运行。这是我们在 Cotlet 投入生产的同一组 17 个 PeoplePerHour 工具:搜索开放项目并阅读完整需求,搜索自由职业者和 Offers 并查看包含近期评价的个人资料,维护项目关注列表和带电子邮件提醒的已保存搜索,查看各类别的预算中位数,以及查看你自己发布的项目、通知和 WorkStreams。
PeoplePerHour 没有公开 API,也没有官方 MCP 服务。这个仓库同时提供两者:
- 面向 Claude Code、Claude Desktop、Cursor、Codex 和任何 MCP 客户端的 MCP 服务,支持 stdio 或 HTTP。设置
- REST API,地址为
http://127.0.0.1:8787/api/v1/peopleperhour,OpenAPI 文档位于/docs。设置 - Python:
call("search_projects", query="web design"),另有 9 个可直接使用的脚本,见examples/。
其中 13 个工具用于读取。其余 4 个只会修改你自己的关注列表和已保存搜索。这里的任何功能都不会发送提案或消息、发布项目、购买 Offer 或付款,也不会消耗 Proposal 点数。
本项目面向希望自行运行的技术人员,仅限非商业用途(许可证)。如果你希望在服务端全天候运行、在 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)
- 像平常一样,在你自己的 Chrome 中登录 PeoplePerHour。勾选 记住我。
peopleperhour-mcp connect通过 Chrome DevTools Protocol 连接到该 Chrome,读取 peopleperhour.com Cookie,并将其保存到~/.config/peopleperhour-api-mcp/session.json;只有你的用户可以读取此文件。它不会查看或存储你的密码。- 每次工具调用都会向 PeoplePerHour 网站本身调用的 JSON API(
www.peopleperhour.com/v2/...)发送请求,并附上这些 Cookie。请求通过 curl_cffi 发送,该库会复制 Chrome 的 TLS 指纹。不会运行无头浏览器。
会话保存在 api Cookie 中;使用“记住我”登录后,该 Cookie 有效期约为 100 天。PeoplePerHour 将你登出后,如果 Chrome 正在运行且已启用远程调试,服务会再次从 Chrome 读取 Cookie。
要求
- Python 3.11 或更高版本。
- Google Chrome 144 或更高版本,并已登录 PeoplePerHour。任何开启调试端口的 Chrome 或 Chromium 均可使用。
- 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 Agent(Claude Code、Codex、Cursor)进行设置?在此文件夹中打开项目,并让它设置仓库:AGENTS.md 会告诉它每个步骤,只有在 Chrome 中操作的步骤才会询问你。
要更新:git pull && pip install -e .。我们会将托管版 PeoplePerHour 工具的所有更改复制到此仓库中。
连接 Chrome
选项 A:日常使用的 Chrome(推荐)
-
在 Chrome 中打开
chrome://inspect/#remote-debugging,并开启远程调试。之后,Chrome 会接受来自这台计算机上程序的 DevTools 连接,并在每次连接前询问你。 -
确保你已登录 peopleperhour.com。
-
运行:
peopleperhour-mcp connect -
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 不会在默认配置文件上开放调试端口,因此请启动一个独立的 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。
选项 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 个工具及其输入架构,并提供面向 Agent 编写的说明。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 还会通过可流式传输的 HTTP 在 http://127.0.0.1:8787/mcp 提供 MCP 服务,适用于接受 URL 的客户端:
peopleperhour-mcp serve
claude mcp add --transport http peopleperhour http://127.0.0.1:8787/mcp
然后可以向 Agent 提出诸如此类的要求:
在 PeoplePerHour 上查找昨天以来发布的网页设计项目,跳过预算低于 £200 或提案数超过 15 的项目,阅读其余项目的需求说明,并为我列出 5 个候选项目。
阅读项目 4527712 的需求说明,打开买家附上的文件,列出我必须交付的内容和需要回答的问题,并起草一份可供我粘贴的提案。
项目 4527712 仍在开放吗?目前有多少份提案?
查找评分达到 80% 或以上、时薪为 £10 至 £30 的 Logo 设计师,阅读排名前 5 位者的个人资料和近期评价,并告诉我应该联系哪 3 位。
保存一项搜索,查找紧急的固定价格设计项目,将其命名为“紧急设计”,并设置每日邮件通知。
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"]
也可以从 shell 调用一个工具:peopleperhour-mcp call get_project project_id=4527712,或使用 JSON 对象。
examples/ 中提供了现成脚本,对应集成页面上的各项工作。每个脚本都支持 --help;列表脚本支持 --out file.csv 或 --out file.json:
| 脚本 | 功能 |
|---|---|
find_new_projects.py | 查找最近 N 小时内匹配一个或多个关键词的新项目,合并结果,并按 --min-budget(或 --hourly-rate)和 --max-proposals 筛选,然后获取每个剩余项目的完整简介、问题和文件。 |
read_project_brief.py | 撰写提案前查看单个项目:简介、附件、买家的问题、提案、到期时间和 80% 的价格下限。 |
watch_urgent_projects.py | 查找提案数少于 N 个的指定类别紧急项目。--state 会记住上次运行结果,适用于每小时执行的 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} | 单个项目的完整简介,包含预算、附件、面试问题、买家信息和提案数量。 |
list_my_projects | 读取 | GET /projects/mine | 此账号作为买家发布的项目,包含状态、预算和提案数量。 |
关注列表
| 工具 | 访问权限 | REST 路由 | 功能说明 |
|---|---|---|---|
watch_project | 写入 | PUT /projects/{project_id}/watch | 将项目添加到此账户的关注列表(收藏的工作),以便日后查看。 |
unwatch_project | 写入 | DELETE /projects/{project_id}/watch | 将项目从此账户的关注列表中移除。 |
list_watchlist | 读取 | GET /projects/watched | 查看此账户关注列表(收藏的工作)中的开放项目,以及预算和提案数量。 |
已保存的搜索
| 工具 | 访问权限 | 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} | 查看一项服务的完整说明、卖家需要你提供的信息、价格、附加项目和图片。 |
账户、通知和 WorkStreams
| 工具 | 访问权限 | REST 路由 | 功能说明 |
|---|---|---|---|
get_account | 读取 | GET /account | 查看已登录的 PeoplePerHour 账户信息:姓名、类型、买家统计数据、未读消息和收藏数量。 |
list_notifications | 读取 | GET /notifications | 查看此账户的最新通知(提案、消息、项目更新)和未读数量。 |
list_workstreams | 读取 | GET /workstreams | 查看此账户的 WorkStreams(与已聘用自由职业者的对话)及最后一条消息。 |
类别
| 工具 | 访问权限 | REST 路由 | 功能说明 |
|---|---|---|---|
list_categories | 读取 | GET /categories | 查看 10 个项目类别及其子类别,以及各自由职业者级别的典型预算。 |
since 可降低轮询成本:Agent 传入上次检查的时间,只读取此后新增的内容。使用 since 的单次调用最多扫描最新的 200 个项目,因此即使一页的项目数少于 limit,也可能仍有 next_cursor。
预算、费率和价格均按 PeoplePerHour 提供的方式返回:项目采用买家的货币;自由职业者费率、服务和预算中位数采用你的账户货币或你所选的货币。
此版本不包含:自由职业者侧的功能(提案、你的卖家个人资料、你自己的服务)、发布或编辑项目、在 WorkStreams 中发送消息、接受提案,以及付款、发票和提案额度。
有意不实现:PeoplePerHour 登录、电子邮件、密码和设置,以及任何会转移资金的功能(提案额度、订阅、付款)。每个请求都会经过一道防护检查,拒绝对这些 PeoplePerHour 路径进行任何更改。
配置
| 变量 | 默认值 | 作用 |
|---|---|---|
PEOPLEPERHOUR_MCP_HOME | ~/.config/peopleperhour-api-mcp | session.json 所在文件夹。 |
PEOPLEPERHOUR_AUTH_TOKEN | PeoplePerHour 的 api cookie,用来替代 peopleperhour-mcp connect。 | |
PEOPLEPERHOUR_PROXY | 发往 PeoplePerHour 的所有请求所用的代理,例如 http://user:pass@host:port。 | |
PEOPLEPERHOUR_MCP_READ_ONLY | 1 会隐藏并拒绝 4 个会更改 PeoplePerHour 数据的工具:关注列表和已保存的搜索(与 --read-only 相同)。 | |
PEOPLEPERHOUR_MCP_TOKEN | serve 所需的 Bearer 令牌;要监听 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。你关注的项目会将你列为关注者,因此请取消关注不再跟进的项目。
- 保持符合正常使用节奏。 每小时运行一次 cron 任务没有问题。每分钟数百次调用并非正常浏览方式;你需要对账户中运行的操作负责。
错误
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 获取最新工具,或提交问题。 |
可自托管或托管服务
| 本仓库 | Cotlet,托管服务 | |
|---|---|---|
| 工具 | 相同的 17 个 | 相同的 17 个 |
| 运行位置 | 在你的电脑上,电脑开启时运行 | 在云端,全天候运行 |
| PeoplePerHour 会话 | 使用你的 Chrome,cookie 保存在本地文件中 | 使用你在欧盟的专属 Cloud Browser,配置文件通过 AES-256-GCM 加密 |
| PeoplePerHour 更改网站时 | 修复完成后运行一次 git pull | 我们会为你修复,每天测试所有工具 |
| 适用对象 | 你机器上的 MCP 客户端、本地脚本 | Claude.ai 和 ChatGPT 连接器、n8n、Make、Zapier,以及任何 HTTP 客户端 |
| 适用用户 | 你本人,限非商业用途 | 团队、企业、代理机构 |
| 价格 | 免费 | 免费试用 7 天,含 2,000 点额度,无需银行卡;之后可购买一次性额度包,5,000 点起价 $29 |
在托管版本中,成功调用消耗 20 到 30 点额度(大多数工具消耗 25 点),失败调用免费;只要 Cloud Browser 为 Agent 启用了应用,每天就会消耗 50 点额度。完整价格。
常见问题
PeoplePerHour 有官方 API 吗?
没有。PeoplePerHour 没有公开 API、开发者文档或 Webhook(截至 2026 年 10 月 12 日核实)。唯一内置的提醒功能是已保存的搜索:你可以在 Jobs 页面保存最多 10 个搜索,并选择即时或每日接收新结果邮件。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 或 Agent 调用 search_projects,并将 since 设为上次检查的时间。watch_urgent_projects.py 会帮你将该时间保存在状态文件中。
它能发送提案或回复买家吗? 不能。此版本不支持提案、WorkStream 消息、购买 Offers、发票和你的 Proposal 积分,也不会消耗任何积分。它可以读取你的 WorkStream 和通知。你需要自行在 PeoplePerHour 上撰写并发送提案和消息。
我能用它在 PeoplePerHour 上雇人吗?
它可以帮你做选择:使用 search_freelancers 和 get_freelancer 查看个人资料和近期评价,使用 search_offers 和 get_offer 查看固定价格的 Offers,使用 list_categories 了解买家通常支付的价格。发布项目、联系自由职业者和付款仍需在 PeoplePerHour 上完成。
我需要付费的 PeoplePerHour 方案或自由职业者帐户吗? 不需要。免费买家帐户即可使用全部 17 个工具。
get_project 会返回项目所需的技能吗?
不会,因为 PeoplePerHour 的项目数据不包含技能列表。技能信息在项目简介文本中,由 Agent 读取。
为什么它需要我的 Chrome? 为了在不使用你密码的情况下读取 PeoplePerHour 会话。每次登录时只需使用一次 Chrome,而非每次调用都使用。
PeoplePerHour 将我登出后会怎样?
调用会因 auth_expired 而失败。如果启用了 Chrome 远程调试,服务会在下次调用时读取新的 Cookie(Chrome 提示时点击“允许”);否则,请重新运行 peopleperhour-mcp connect。
它能在 VPS 或 Docker 中运行吗?
技术上可以,但需要设置 PEOPLEPERHOUR_AUTH_TOKEN。这样 PeoplePerHour 看到的会是来自数据中心 IP 的会话,看起来就不那么像你本人。若要始终在线运行,托管版本会将你的会话保存在你自己的 Cloud Browser 中,并使用固定 IP。
我的 PeoplePerHour 帐户会被封禁吗? 请求会携带 Chrome 的指纹,并且每次只发送一个;这些工具只读取你自己能够打开的内容。没人能保证平台永远不会采取措施。请将轮询频率控制在人类操作的合理范围内。
我能在工作中或为客户使用它吗? 不能,许可证仅允许非商业用途。团队、公司或客户项目请使用 Cotlet,或发送邮件至 [email protected]。
它是开源的吗? 源代码是公开的,但许可证并非开源许可证:仅限非商业用途,不得用于商业活动。
某个工具出问题了,或者我需要另一个工具。 请提交问题,并注明工具名称和错误消息。
许可证
PolyForm Noncommercial License 1.0.0。简而言之:
- **允许:**非商业用途:你使用自己的 PeoplePerHour 账户处理个人事务,或慈善机构、学校、公共研究机构或政府机构使用。修改代码,并按相同许可证分享。
- **不允许:**任何商业用途,包括经营自己的业务;客户项目;销售或提供该代码,或基于该代码构建的服务。
由 Cotlet(@cotletdev)维护。PeoplePerHour 是其所有者的商标。本项目为非官方项目,与 PeoplePerHour 无关联,也未获得其认可或赞助。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。