upwork-research

Upwork 研究

搜索 Upwork 职位并获取自由职业者档案——所有数据均来自 Crawlora API 的标准化 JSON，无需手动抓取 Upwork 页面。

何时使用此技能

• “在 Upwork 上搜索 <技能/职位> 职位。”——对公开职位列表进行自由文本关键词搜索。
• “给我看看这个 Upwork 职位。”——按职位 ID 获取完整详情（预算、描述、客户历史记录）。
• “查一下这位 Upwork 自由职业者。”——按自由职业者 ID 获取档案、时薪、Job Success Score、评分和近期客户反馈。
• “Upwork 上 <技能> 的行情如何？”——收集搜索结果中的预算，估算市场价格。
• “雇用这位自由职业者前先审核一下。”——一次调用即可获取其档案和反馈历史记录。

设置（一次性）

• 在 https://crawlora.net 免费获取 Crawlora API 密钥（每月 2,000 点数，无需信用卡）。
• 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

1. 搜索——/upwork/search 接受自由文本关键词（q），并返回标准化职位摘要（标题、预算、经验级别、时长、发布日期、描述摘要、技能标签），可通过 page 分页。
2. 职位详情——从搜索结果中获取一个 id，并调用 /upwork/job/{id} 获取完整职位信息：描述、雇用类型、预算（时薪范围或固定金额）、地点/远程类型、经验级别、时长、项目类型、提案数量、允许申请者所在的国家/地区，以及职位发布客户的摘要（加入时间、地点、支出、雇用人数、工时、行业、公司规模）。
3. 自由职业者档案——/upwork/freelancer/{id} 返回标准化档案：姓名、头衔、验证徽章、简介、时薪、评分和评论数、Job Success Score、地点和当地时间、累计工作数/工时，以及近期客户反馈（标题、评论、日期、客户姓名、评分）。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Search jobs by keyword:
scripts/crawlora.sh /upwork/search q="react developer" | jq '.'

# Job detail (id from a search result):
scripts/crawlora.sh /upwork/job/<job_id> | jq '.'

# Freelancer profile (id from a search result or a known profile):
scripts/crawlora.sh /upwork/freelancer/<freelancer_id> | jq '.'

所有请求都使用 scripts/crawlora.sh；它不会将 API 密钥暴露在命令行参数中。

端点参考

此技能使用的所有 Upwork 端点，请参阅 reference/endpoints.md。

示例

• **自由职业费率查询：**针对某项技能搜索 /upwork/search（例如 q="react developer"），收集搜索结果中的 budget 字段，估算该技能的市场价格。
• **自由职业者尽职调查：**通过 /upwork/search 或已知 ID 找到候选人，然后调用 /upwork/freelancer/{id}，在联系对方之前查看其 Job Success Score、时薪、工时和近期客户反馈。

说明与限制

• **点数 / 成功后付费：**仅在返回 2xx 时计费；免费套餐每月 2,000 点数。请在 https://crawlora.net 获取密钥。
• 仅限公开数据——公开职位和档案；请遵守 Upwork 的条款。
• **安全性：**密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、作为查询参数传递或提交到代码库。
• 职位和自由职业者 ID 均来自搜索结果——从 /upwork/search 的输出中获取 id 字段，而不要猜测。
• 数据来自 Upwork 自己通过真实浏览器渲染后端呈现的页面，因此字段准确反映页面上公开可见的内容（不包括 Upwork 登录墙后的数据）。
• /upwork/search 使用分页——传入 page，即可继续浏览第一页之后的结果。