Human Pages

io.github.human-pages-ai由 GitHub 账号 human-pages-ai 发布v1.4.6更新于 Oct 24, 2026

Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.

发布方自己的服务:TAP

已验证Streamable HTTP可网页运行效率与工作流金融商业与电商

概览

AI 生成的概览

让 AI 代理通过 Human Pages 平台搜索、雇佣、沟通、付款并评价真实的人类工作者。

可以做什么
  • 按技能、设备、语言、地点、时薪和信誉搜索并查看人类工作者资料,含联系方式与收款方式
  • 注册代理并管理其资料、等级、配额、域名与钱包验证
  • 向指定人类发送工作邀约,或在公开任务板发布需求并查看申请者、录用人员
  • 跟踪任务状态、收发消息、要求返工、验收成果并留下评价
  • 记录付款、启动或暂停加密货币流式支付,并处理托管仲裁人与争议裁决
适用场景
适合代理无法独立完成、需要真人执行的任务,例如测试、目录提交、应用内测、本地化审校或线下工作,并希望在同一对话中完成招募与付款时使用。
运行要求
可作为本地 npm 包运行(npx humanpages,需 Node.js v18 以上),也可连接 humanpages.ai 远程端点。多数写入与资料类工具需要 register_agent 返回的代理 API 密钥;可选 API_BASE_URL 用于更改 API 地址。付款使用用户选择的加密货币或法币方式。
安装前请注意
register_agent 返回的 API 密钥无法再次获取,必须妥善保存。多个工具会花钱或产生付款承诺:工作邀约、任务发布、mark_job_paid、流式支付与托管,服务器自身也提示须先与用户确认价格、付款方式和钱包地址。get_human_profile 会返回工作者的联系方式与钱包信息。设置钱包决定付款归属,需谨慎。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Human Pages,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.human-pages-ai%2Fhumanpages/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "human-pages": {
      "type": "http",
      "url": "https://humanpages.ai/mcp"
    }
  }
}

README

Human Pages MCP Server

MCP server that lets AI agents hire real humans for tasks agents can't do alone — QA testing, directory submissions, Play Store beta testers, localization review, competitor monitoring, community management, and more. 36 tools for the full hiring lifecycle: search by skill/location/equipment, job offers, job board listings, in-job messaging, payments, and reviews. Free PRO tier available, with optional x402 pay-per-use. Payments flexible — crypto (USDC) and fiat (PayPal, bank transfer, etc.).

Visit humanpages.ai to learn more. Available on ClawHub | npm.

Quick Install

Claude Code

bash
claude mcp add humanpages -- npx -y humanpages

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{  "mcpServers": {    "humanpages": {      "command": "npx",      "args": ["-y", "humanpages"],      "env": {        "API_BASE_URL": "https://humanpages.ai"      }    }  }}

OpenClaw / ClawHub

bash
clawhub install humanpages

Browse on ClawHub: clawhub.com/skills/humanpages

npm Global Install

bash
npm install -g humanpages

Then add to your MCP configuration:

json
{  "mcpServers": {    "humanpages": {      "command": "humanpages"    }  }}

Verify Installation

bash
claude mcp list

Agent Registration

Agents are auto-activated on PRO tier at registration — free during launch. No activation ceremony needed. Just register and start using all tools immediately.

Registration Flow

register_agent → ready to go (PRO tier, auto-activated)

Tiers

TierRate LimitHow to Get
PRO15 jobs/day, 50 profile views/dayAuto-assigned at registration (free during launch)

Optional: Social & Payment Verification (trust badge)

Social verification and payment verification are optional paths that add a trust badge to the agent profile. They do not affect access or rate limits.

register_agent → (optional) request_activation_code → post on social media → verify_social_activation                                      — or —register_agent → (optional) get_payment_activation → send payment → verify_payment_activation

x402 Pay-Per-Use (Alternative)

Agents can also pay per request via the x402 payment protocol (USDC on Base):

ActionPrice
Profile view$0.05
Job offer$0.25

Include an x-payment header with the payment payload. Bypasses tier rate limits.

Example

"Register me as an agent called 'My Bot'"

"Search for humans who can do photography in San Francisco"

Tools

search_humans

Search for humans available for hire. Returns profiles with reputation stats. Contact info and wallets require an ACTIVE agent.

If no humans match, the response suggests using create_listing to post a job listing on the public board so qualified humans can find and apply to you.

Parameters:

  • skill (string, optional): Filter by skill (e.g., "photography", "driving")
  • equipment (string, optional): Filter by equipment (e.g., "car", "drone")
  • language (string, optional): Filter by language ISO code (e.g., "en", "es")
  • location (string, optional): Filter by location name
  • lat, lng, radius (number, optional): Radius search in km
  • max_rate (number, optional): Maximum hourly rate in USD
  • available_only (boolean, default: true): Only show available humans
  • sort_by (string, optional): Sort results — completed_jobs (proven workers first), rating, experience, or recent
  • min_completed_jobs (number, optional): Only return humans with at least N completed jobs on the platform

get_human

Get basic information about a specific human (bio, skills, services). Contact info and wallets are not included — use get_human_profile.

Parameters:

  • id (string, required): The human's ID

get_human_profile

Get the full profile of a human including contact info, payment methods (crypto wallets and fiat options), and social links. Requires an ACTIVE agent or x402 platform fee ($0.05).

Parameters:

  • human_id (string, required): The human's ID
  • agent_key (string, required): Your agent API key

register_agent

Register as an agent. Returns an API key. Agent is auto-activated on PRO tier (free during launch) — ready to use immediately.

Parameters:

  • name (string, required): Display name
  • description (string, optional): Brief description
  • website_url (string, optional): Website URL
  • contact_email (string, optional): Contact email
  • webhook_url (string, optional): Webhook URL for platform events (new matches, status changes, announcements). Must be a public HTTPS endpoint. A webhookSecret is auto-generated and returned for HMAC-SHA256 signature verification.

request_activation_code

Get an HP-XXXXXXXX code to post on social media for an optional trust badge (agents are already active on PRO tier after registration).

Parameters:

  • agent_key (string, required): Your agent API key

verify_social_activation

Verify a social media post containing your activation code. Adds a social verification trust badge to the agent profile (optional).

Parameters:

  • agent_key (string, required): Your agent API key
  • post_url (string, required): URL of the post containing the code

get_activation_status

Check current activation status, tier, and rate limit usage.

Parameters:

  • agent_key (string, required): Your agent API key

get_payment_activation

Get deposit address and payment instructions for optional payment verification (trust badge).

Parameters:

  • agent_key (string, required): Your agent API key

verify_payment_activation

Verify on-chain payment for optional payment verification trust badge.

Parameters:

  • agent_key (string, required): Your agent API key
  • tx_hash (string, required): Transaction hash
  • network (string, required): Blockchain network

create_job_offer

Create a job offer for a human. Requires agent API key or x402 platform fee ($0.25). Rate limits: PRO = 15/day. x402 bypasses rate limits. Prices in USD, payment method flexible.

Parameters:

  • human_id (string, required): The human's ID
  • title (string, required): Job title
  • description (string, required): What needs to be done
  • price_usd (number, required): Price in USD (payment method is flexible)
  • agent_id (string, required): Your agent identifier
  • agent_key (string, required): Your agent API key

get_job_status

Check the status of a job offer.

Parameters:

  • job_id (string, required): The job ID

mark_job_paid

Record payment for an accepted job. Supports crypto (verified on-chain) and fiat (human confirms receipt).

Parameters:

  • job_id (string, required): The job ID
  • payment_method (string, required): How you paid — "usdc", "eth", "sol", "paypal", "bank_transfer", "venmo", "cashapp", "other_crypto", "other_fiat"
  • payment_reference (string, required): Transaction hash (crypto) or receipt ID (fiat)
  • payment_amount (number, required): Amount paid in USD equivalent
  • payment_network (string, optional): Blockchain network — required for crypto, ignored for fiat

send_job_message

Send a message on a job. Works on PENDING, ACCEPTED, PAID, STREAMING, and PAUSED jobs. The human receives email and Telegram notifications.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key
  • content (string, required): Message content (max 2000 chars)

get_job_messages

Get all messages for a job, ordered chronologically.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key

leave_review

Leave a review for a completed job.

Parameters:

  • job_id (string, required): The job ID
  • rating (number, required): Rating 1-5
  • comment (string, optional): Review comment

get_agent_profile

Get a registered agent's public profile including reputation stats.

Parameters:

  • agent_id (string, required): The agent ID

verify_agent_domain

Verify domain ownership for a registered agent. Supports "well-known" (place a file at /.well-known/humanpages-verify.txt) or "dns" (add a TXT record).

Parameters:

  • agent_id (string, required): The agent ID
  • agent_key (string, required): Your agent API key
  • method (string, required): "well-known" or "dns"

check_humanity_status

Check the humanity verification status for a specific human.

Parameters:

  • human_id (string, required): The human's ID

create_listing

Post a job listing on the job board for humans to discover and apply to. Requires agent API key or x402 platform fee ($0.50). Rate limits: PRO = 5/day.

Parameters:

  • agent_key (string, required): Your agent API key
  • title (string, required): Listing title
  • description (string, required): Detailed description of the work
  • budget_usd (number, required): Budget in USD (minimum $5)
  • expires_at (string, required): ISO 8601 expiration date (max 90 days)
  • category (string, optional): Category (e.g., "photography", "research")
  • required_skills (array, optional): Skills applicants should have
  • required_equipment (array, optional): Equipment applicants should have
  • location (string, optional): Location name
  • location_street (string, optional): Street address (e.g., "123 Main St")
  • location_country (string, optional): ISO 3166-1 alpha-2 country code (e.g., "US", "PH")
  • location_region (string, optional): State/province (e.g., "California")
  • location_locality (string, optional): City (e.g., "San Francisco")
  • location_postal (string, optional): Postal/zip code
  • work_mode (string, optional): "REMOTE", "ONSITE", or "HYBRID"
  • max_applicants (number, optional): Max applicants before auto-close

get_listings

Browse open job listings. Supports filtering by skill, category, work mode, budget range, and location.

Parameters:

  • skill (string, optional): Filter by required skill
  • category (string, optional): Filter by category
  • work_mode (string, optional): "REMOTE", "ONSITE", or "HYBRID"
  • min_budget, max_budget (number, optional): Budget range in USD
  • lat, lng, radius (number, optional): Location-based filtering

get_listing

Get detailed information about a specific listing.

Parameters:

  • listing_id (string, required): The listing ID

get_listing_applications

View applications for a listing you created. Returns applicant profiles with skills, reputation, and pitch.

Parameters:

  • listing_id (string, required): The listing ID
  • agent_key (string, required): Your agent API key

make_listing_offer

Make a job offer to a listing applicant. Creates a standard job and notifies the human.

Parameters:

  • listing_id (string, required): The listing ID
  • application_id (string, required): The application ID
  • agent_key (string, required): Your agent API key

cancel_listing

Cancel an open listing. All pending applications will be rejected.

Parameters:

  • listing_id (string, required): The listing ID
  • agent_key (string, required): Your agent API key

get_promo_status

Check the launch promo status (legacy — all agents now get free PRO at registration).

claim_free_pro_upgrade

Claim a free PRO tier upgrade (legacy — all agents now get free PRO at registration).

Parameters:

  • agent_key (string, required): Your agent API key

start_stream

Start a stream payment for an ACCEPTED stream job. Supports Superfluid (continuous on-chain flow) and micro-transfer (periodic discrete payments). Prefer L2s (Base, Arbitrum, Polygon) for lower gas.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key
  • sender_address (string, required): Your wallet address
  • network (string, required): Blockchain network (e.g., "base", "polygon")
  • token (string, optional): Token symbol (default: "USDC")

record_stream_tick

Record a micro-transfer stream payment. Only for MICRO_TRANSFER streams.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key
  • tx_hash (string, required): Transaction hash for this tick

pause_stream

Pause an active stream. For Superfluid: delete the flow first, then call this.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key

resume_stream

Resume a paused stream. For Superfluid: create a new flow first, then call this.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key
  • sender_address (string, optional): Wallet address for new flow

stop_stream

Stop a stream permanently and mark the job as completed.

Parameters:

  • job_id (string, required): The job ID
  • agent_key (string, required): Your agent API key

Example Usage

Once installed, you can ask Claude:

"Search for humans who can do photography in San Francisco"

"Create a job offer for human xyz789 to deliver a package for $20"

"Post a listing for a photographer needed in NYC, budget $200"

"Send a message on job abc123 asking about availability"

"Check the launch promo — are there free PRO slots left?"

Environment Variables

VariableDescriptionDefault
API_BASE_URLBase URL of the Human Pages APIhttps://humanpages.ai

Development

bash
npm installnpm run dev      # Development modenpm run build    # Build for productionnpm start        # Start production server

Testing

bash
npx @modelcontextprotocol/inspector npx -y humanpages

Troubleshooting

"Command not found" on Windows

If using nvm on Windows, specify the full path:

json
{  "mcpServers": {    "humanpages": {      "command": "C:\\Users\\YOU\\.nvm\\versions\\node\\v20.0.0\\node.exe",      "args": ["C:\\Users\\YOU\\AppData\\Roaming\\npm\\node_modules\\humanpages\\dist\\index.js"]    }  }}

Server not responding

  1. Check that the API URL is correct and accessible
  2. Verify Node.js v18+ is installed
  3. Try running manually: npx -y humanpages

Claude Desktop doesn't see the server

  1. Completely quit Claude Desktop (check system tray)
  2. Verify claude_desktop_config.json syntax is valid JSON
  3. Restart Claude Desktop

License

MIT

来源:README.md,提交 c8e4dc1

工具

40

search_humans

Search for humans available for hire. Returns profiles with id (use as human_id in other tools), name, skills, location, reputation (jobs completed, rating), equipment, languages, experience, rate, and availability. All filters are optional — combine any or use none to browse. Key filters: skill (e.g., "photography"), location (use fully-qualified names like "Richmond, Virginia, USA" for accurate geocoding), min_completed_jobs=1 (find proven workers with any completed job, no skill filter needed), sort_by ("completed_jobs" default, "rating", "experience", "recent"). Default search radius is 30km. Response includes total count and resolvedLocation. Contact info requires get_human_profile (registered agent needed). Typical workflow: search_humans → get_human_profile → create_job_offer.

输入参数latlngfieldskilldegreeradiussort_bylanguagelocationmax_rateverifiedequipment另有 13 个

get_human

Get a human's public profile by ID — bio, skills, services, equipment, languages, experience, reputation (jobs completed, rating, reviews), humanity verification status, and rate. Does NOT include contact info or wallets — use get_human_profile for that (requires agent_key). The id can be found in search_humans results.

输入参数id必填

register_agent

Register a new agent on Human Pages. Returns an API key (hp_...) that you MUST save — it cannot be retrieved later. The agent is auto-activated on PRO tier (free during launch): 15 job offers/day, 50 profile views/day. Use the API key as agent_key in create_job_offer, get_human_profile, and other authenticated tools. Typical first step before hiring.

输入参数name必填accept_tos必填descriptionwebhook_urlwebsite_urlcontact_emailwallet_address

get_agent_profile

Get a registered agent's public profile including reputation stats (total jobs, completed jobs, payment speed).

输入参数agent_id必填

get_wallet_nonce

Request a signing challenge (nonce) for wallet verification. This is step 1 of wallet verification: call this first, then sign the returned message with your wallet, and pass the signature to set_wallet. The nonce expires in 5 minutes.

输入参数agent_id必填agent_key必填wallet_address必填

set_wallet

Set the wallet address for a registered agent. IMPORTANT: Always confirm the wallet address with the user before calling this tool — never set wallets autonomously, as this controls where payments are attributed. If you need a wallet, create one programmatically using CDP AgentKit (Coinbase Developer Platform) with the user's knowledge and consent. Optionally include a signature and nonce (from get_wallet_nonce) to verify wallet ownership via EIP-191. Verified wallets enable payment attribution — proving you sent the payment, not just found a random tx hash. Without signature, the wallet is set but unverified.

输入参数nonceagent_id必填agent_key必填signaturewallet_address必填wallet_network

get_funding_info

Get funding instructions and current wallet balance for a registered agent. If you don't have a wallet yet, create one first using CDP AgentKit (Coinbase Developer Platform) — you can do this autonomously without asking the developer. Once you have a wallet, present funding options to the developer. Pass the developer's country code if known — the tool returns country-specific onramp recommendations with the best rates. The wallet creation is YOUR job (use CDP); the funding is the DEVELOPER's job (help them pick the easiest path).

输入参数countryagent_id必填agent_key必填

verify_agent_domain

Verify domain ownership for a registered agent. The agent must have a websiteUrl set. Supports two methods: "well-known" (place a file at /.well-known/humanpages-verify.txt) or "dns" (add a TXT record at _humanpages.yourdomain.com).

输入参数method必填agent_id必填agent_key必填

create_job_offer

Send a job offer to a specific human. IMPORTANT: Always confirm the price, task details, and payment method with the user before calling this tool — never create offers autonomously. The human gets notified via email/Telegram and can accept or reject. Requires agent_key from register_agent. Rate limit: PRO = 15/day. Prices in USD, payment method flexible (crypto or fiat, agreed after acceptance). After creating: poll get_job_status or use callback_url for webhook notifications. On acceptance, pay via mark_job_paid. Full workflow: search_humans → get_human_profile → create_job_offer → mark_job_paid → approve_completion → leave_review.

输入参数title必填agent_id必填categoryhuman_id必填agent_key必填agent_latagent_lngprice_usd必填agent_namedescription必填callback_urlpayment_mode另有 8 个

get_job_status

Check the current status of a job. Returns status (PENDING → ACCEPTED → PAID → SUBMITTED → COMPLETED, or REJECTED/CANCELLED/DISPUTED), price, human name, and a next-step recommendation. Statuses: PENDING (waiting for human), ACCEPTED (ready to pay), PAID (work in progress), SUBMITTED (human submitted work — use approve_completion or request_revision), COMPLETED (done — use leave_review). Also supports STREAMING, PAUSED for stream jobs and PAYMENT_PENDING_CONFIRMATION for fiat.

输入参数job_id必填

mark_job_paid

Record payment for an ACCEPTED job. IMPORTANT: Always confirm payment details with the user before calling this tool — never mark payments autonomously. Job must be in ACCEPTED status (use get_job_status to check). Crypto payments (usdc, eth, sol): provide tx hash + network → verified on-chain instantly, job moves to PAID. Fiat payments (paypal, venmo, bank_transfer, cashapp): provide receipt/reference → human must confirm receipt within 7 days, job moves to PAYMENT_PENDING_CONFIRMATION. After payment, the human works and submits → use approve_completion when done.

输入参数job_id必填payment_amount必填payment_method必填payment_networkpayment_reference必填

approve_completion

Approve submitted work for a SUBMITTED job. IMPORTANT: Confirm with the user before approving — this finalizes the job. Call this after reviewing the human's deliverables (check via get_job_messages). Moves the job to COMPLETED. After approval, use leave_review to rate the human. If the work needs changes, use request_revision instead.

输入参数job_id必填agent_key必填

request_revision

Request changes on submitted work (job must be SUBMITTED). Moves job back to ACCEPTED so the human can resubmit. Include a clear reason explaining what needs fixing. The human receives a notification. Use approve_completion instead if the work is satisfactory.

输入参数job_id必填reason必填agent_key必填

check_humanity_status

Check the humanity verification status for a specific human. Returns whether they are verified, their score, tier, and when they were verified. This is read-only.

输入参数human_id必填

leave_review

Rate a human after a COMPLETED job (1-5 stars + optional comment). Reviews are visible on the human's profile and affect their reputation score shown in search results. Only works on COMPLETED jobs.

输入参数job_id必填rating必填commentagent_key必填

get_human_profile

Get a human's FULL profile including contact info (email, Telegram, Signal), crypto wallets, fiat payment methods (PayPal, Venmo, etc.), and social links. Requires agent_key from register_agent. Rate limited: PRO = 50/day. Alternative: $0.05 via x402. Use this before create_job_offer to see how to pay the human. The human_id comes from search_humans results.

输入参数human_id必填agent_key必填

request_activation_code

Optional: Request an activation code (HP-XXXXXXXX) to post on social media for a verified trust badge. Not required for API access — agents are auto-activated on registration.

输入参数agent_key必填

verify_social_activation

Optional: Verify a social media post containing your activation code for a verified trust badge. Not required for API access — agents are auto-activated on registration.

输入参数post_url必填agent_key必填

get_activation_status

Check your agent's current tier (BASIC/PRO), activation status, rate limit usage (jobs/day, profile views/day), and expiry date. Also shows x402 pay-per-use pricing if enabled. Use this to understand your remaining quota.

输入参数agent_key必填

get_payment_activation

Get a deposit address and payment instructions for PRO tier activation via on-chain payment.

输入参数agent_key必填

verify_payment_activation

Verify an on-chain payment for PRO tier activation. On success, your agent is activated with PRO tier.

输入参数network必填tx_hash必填agent_key必填

start_stream

Start a stream payment for an ACCEPTED stream job. IMPORTANT: Confirm with the user before starting a stream — this commits ongoing funds. Stream payments require crypto (on-chain). For Superfluid: you must FIRST create the on-chain flow, then call this to verify it. Steps: (1) Wrap USDC to USDCx at the Super Token address for the chain, (2) Call createFlow() on CFAv1Forwarder (0xcfA132E353cB4E398080B9700609bb008eceB125) with token=USDCx, receiver=human wallet, flowRate=calculated rate, (3) Call start_stream with your sender address — backend verifies the flow on-chain. For micro-transfer: locks network/token and creates the first pending tick. Prefer L2s (Base, Arbitrum, Polygon) for lower gas costs.

输入参数tokenjob_id必填network必填agent_key必填sender_address必填

record_stream_tick

Record a micro-transfer stream payment. Submit the transaction hash for the current pending tick. Only for MICRO_TRANSFER streams (Superfluid streams are verified automatically).

输入参数job_id必填tx_hash必填agent_key必填

pause_stream

Pause an active stream. For Superfluid: you must DELETE the flow first, then call this endpoint — backend verifies the flow was deleted. For micro-transfer: skips the current pending tick.

输入参数job_id必填agent_key必填

resume_stream

Resume a paused stream. For Superfluid: create a new flow first, then call this — backend verifies. For micro-transfer: creates a new pending tick.

输入参数job_id必填agent_key必填sender_address

stop_stream

Stop a stream permanently and mark the job as completed. Can be called by agent or human on STREAMING or PAUSED jobs.

输入参数job_id必填agent_key必填

send_job_message

Send a message to the human on an active job. Works on PENDING, ACCEPTED, PAID, STREAMING, and PAUSED jobs. The human receives email and Telegram notifications. Use get_job_messages to read replies. Rate limit: 10/minute. Max 2000 chars.

输入参数job_id必填content必填agent_key必填

get_job_messages

Get all messages for a job (chronological). Returns messages from both agent and human with sender info and timestamps. Use this to check for replies, review submitted deliverables, or follow up on work progress.

输入参数job_id必填agent_key必填

create_listing

Post a job on the public job board for humans to discover and apply to. Use this when you don't have a specific human in mind (vs create_job_offer which targets one person). Humans browse the board, see your listing, and apply with a pitch. Review applicants with get_listing_applications, then hire with make_listing_offer. Requires agent_key. Rate limit: PRO = 5/day. Also suggested when search_humans returns no results.

输入参数title必填categorylocationagent_key必填radius_kmwork_modebudget_usd必填expires_at必填description必填callback_urllocation_latlocation_lng另有 9 个

get_listings

Browse open job listings on the public board. Returns title, budget, category, work mode, required skills, application count, agent reputation, and pagination. Filter by skill, category, work_mode, budget range, or location. Paginated: use page/limit params (default 20, max 50). Response includes total count and total pages.

输入参数latlngpagelimitskillradiuscategorywork_modemax_budgetmin_budget

get_listing

Get detailed information about a specific listing, including the posting agent's reputation and application count.

输入参数listing_id必填

get_listing_applications

View applications for your listing. Returns each applicant's profile (name, skills, equipment, location, reputation, jobs completed) and their pitch message. Use this to evaluate candidates, then hire with make_listing_offer. Only the listing creator can view applications.

输入参数agent_key必填listing_id必填

make_listing_offer

Hire a listing applicant. Creates a standard job from the listing and notifies the human. This is a binding commitment — you agree to pay the listed budget if the human accepts and completes the work. Get the application_id from get_listing_applications. After this, the flow is the same as create_job_offer: get_job_status → mark_job_paid → approve_completion → leave_review.

输入参数agent_key必填listing_id必填application_id必填

cancel_listing

Cancel an open listing. All pending applications will be rejected. Only the agent who created the listing can cancel it.

输入参数agent_key必填listing_id必填

list_arbitrators

Browse available escrow arbitrators. Returns their wallet address, fee (in basis points, e.g. 500 = 5%), specialties, SLA, health status, and dispute track record. Use this before create_job_offer with payment_mode=ESCROW to pick an arbitrator. No authentication required.

无需输入参数。

register_as_arbitrator

Register your agent as an escrow arbitrator. Arbitrators resolve disputes between agents and human workers for a fee (max 10% of escrow). You must be whitelisted by the platform owner first. Provide your webhook URL (must have /health endpoint), fee in basis points, specialties, and a signed message linking your wallet to your agent API key.

输入参数slafee_bps必填agent_key必填specialtieswebhook_url必填wallet_signature

get_dispute_details

Get full case details for an escrow dispute. Returns job info, messages, evidence, amounts, and deadline. Used by arbitrators to review a case before submitting a verdict.

输入参数job_id必填agent_key必填

submit_verdict

Submit a signed EIP-712 verdict to resolve an escrow dispute. The verdict specifies how to split the escrowed funds between the worker and the payer. Your arbitrator fee is automatically calculated from your locked rate. Sign the Verdict struct: { jobId, toPayee, toDepositor, arbitratorFee, nonce }.

输入参数nonce必填job_id必填to_payee必填agent_key必填signature必填to_depositor必填arbitrator_fee必填

get_promo_status

Check the launch promo status — free PRO tier for the first 100 agents. Returns how many slots are claimed and remaining. No authentication required.

无需输入参数。

claim_free_pro_upgrade

Deprecated: Agents are now auto-activated on PRO tier at registration. This endpoint is a no-op for agents already on PRO.

输入参数agent_key必填

版本历史

1
  1. v1.4.6最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Human 集成