SuperAPI AI 工具集

upwork-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:该技能用于检索 Upwork 的公开职位信息和自由职业者资料,通过 Crawlora API 返回规范化 JSON,避免手动抓取 Upwork 页面。

主要能力:

  1. 职位搜索:/upwork/search 接受自由文本关键词(q),返回规范化职位摘要,包括标题、预算、经验等级、时长、发布日期、描述片段和技能标签,通过 page 分页。
  2. 职位详情:用搜索结果中的 id 调用 /upwork/job/{id},获取完整职位信息,包括描述、雇佣类型、预算(时薪范围或固定金额)、地点/远程类型、经验等级、时长、项目类型、提案数量、允许申请的国家,以及发布客户的摘要(注册时间、地点、支出、雇佣数、工时、行业、公司规模)。
  3. 自由职业者档案:/upwork/freelancer/{id} 返回规范化档案,包括姓名、头衔、认证徽章、简介、时薪、评分与评价数、Job Success Score、地点与当地时间、总工作数/工时,以及近期客户反馈(标题、评论、日期、客户名、评分)。

使用方式: 一次性设置:在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2,000 积分,无需信用卡),在运行辅助脚本前设置环境变量 CRAWLORA_API_KEY。辅助脚本从环境变量读取密钥,请求发送至 https://api.crawlora.net/api/v1,密钥缺失或无效返回 401。

调用示例: scripts/crawlora.sh /upwork/search q="react developer" | jq '.' scripts/crawlora.sh /upwork/job/<job_id> | jq '.' scripts/crawlora.sh /upwork/freelancer/<freelancer_id> | jq '.' 所有请求均使用 scripts/crawlora.sh,以避免密钥出现在命令行参数中。完整端点列表、方法和参数见 reference/endpoints.md。

适用场景:按技能或角色搜索职位;查看某条职位详情;查询某位自由职业者;收集搜索结果中的预算字段以估算市场费率;招聘前核查候选人的 Job Success Score、时薪、工时和近期客户反馈。

限制与注意事项:仅计费 2xx 响应,免费层每月 2,000 积分;仅限公开数据,需遵守 Upwork 条款;密钥只存放在 CRAWLORA_API_KEY 中,切勿硬编码、放入查询参数或提交到仓库;职位和自由职业者 id 需从搜索结果中获取,不要猜测;数据来自 Upwork 服务器渲染页面,通过真实浏览器渲染后端获取,字段反映页面上公开可见的内容,不含登录墙后的数据;/upwork/search 分页,需传入 page 翻页。