job-market-research

求职市场与招聘研究

搜索招聘信息，直接从公司的 ATS 获取其实时职位空缺， 并研究自由职业机会——所有数据均通过 Crawlora API 以标准化 JSON 返回， 无需手动抓取招聘网站或 ATS 页面。

何时使用此技能

• “搜索 在 的职位。”（Indeed、Google/Amazon/Apple/Meta/Tesla 职业招聘页面）
• “ 目前在招聘什么职位？”——直接获取其 ATS 职位列表。
• “ 使用哪个 ATS？”／“查找任意公司的招聘页面。”
• “ 是否在积极招聘？”——汇总招聘信号并进行分析。
• “查找 相关的自由职业者／项目”（Upwork、Fiverr）。

设置（一次性）

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

工作原理

1. 招聘网站与搜索引擎 — /indeed/search（关键词 + 地点）、 /google-jobs/search（careers.google.com），以及针对相应雇主的专用 /amazon-jobs/search、/apple-jobs/search、/meta-jobs/search、 /tesla-jobs/list。每个接口都有对应的 .../job （或 /list／/board）详情接口，用于获取单条招聘信息。
2. 任意公司的 ATS 职位列表 — 首先确定公司使用的系统： /jobs/company-search 会探测 Greenhouse、Lever、Ashby、SmartRecruiters、 Workday 等系统，查找公司的 slug。然后通过对应接口列出职位：/jobs/greenhouse/board（参数 token）、/jobs/lever/postings、 /jobs/workday/board、/jobs/smartrecruiters/postings、 /jobs/ashby/board（参数 org）、/jobs/recruitee/offers、/jobs/workable/postings、 /jobs/rippling/board、/jobs/icims/board、/jobs/oracle/board、 /jobs/ukg/board、/jobs/personio/feed、/jobs/pinpoint/board、 /jobs/teamtailor/jobs、/jobs/eightfold/board、/jobs/gem/board——每种 ATS 对应一个接口，且都有对应的单条招聘信息详情接口。 各 ATS 使用各自的 slug 参数名称（token、company、org、 tenant+datacenter+site 或 domain）——请参阅 reference/endpoints.md。
3. 招聘信号 — /jobs/hiring-signals 会在一次调用中汇总公司的 ATS 职位列表，生成招聘速度摘要（人员增长的代理指标）。传入 provider（ATS 名称）以及该服务提供商的 slug 参数 （例如 provider=greenhouse + token=<slug>，或 provider=ashby + org=<slug>）。
4. 自由职业 — 使用 /upwork/search／/fiverr/search 搜索项目和职位； 使用 /upwork/job/{id}、/fiverr/gig/{username}/{slug} 获取详情； 使用 /upwork/freelancer/{id}、/fiverr/seller/{username} 获取个人资料。

完整接口列表、方法和参数：reference/endpoints.md。

调用 API

# Search:
scripts/crawlora.sh /indeed/search q="staff engineer" l="Remote" | jq '.'

# Resolve then pull a company's ATS board:
scripts/crawlora.sh /jobs/company-search slug=stripe | jq '.'
scripts/crawlora.sh /jobs/greenhouse/board token=stripe | jq '.data'

# Hiring signals:
scripts/crawlora.sh /jobs/hiring-signals provider=greenhouse token=stripe | jq '.'

# Freelance:
scripts/crawlora.sh /upwork/search q="react developer" | jq '.'

所有请求均使用 scripts/crawlora.sh；它可以避免 API 密钥出现在命令行参数中。

接口参考

请参阅 reference/endpoints.md，查看此技能使用的所有 Indeed、 Google/Amazon/Apple/Meta/Tesla Jobs、ATS（Jobs 组）、Upwork 和 Fiverr 接口。

示例

• “公司 X 正在扩大规模吗？”——使用 /jobs/company-search 查找其职位列表， 使用 /jobs/hiring-signals 获取招聘速度摘要，然后调用原始职位列表接口， 查看哪些团队／职位正在招聘。
• **跨来源职位搜索：**针对相同职位名称／地点调用 /indeed/search + /google-jobs/search， 按公司 + 职位名称去重。
• **竞争对手招聘监控：**定期获取 3-4 家竞争对手的 ATS 职位列表，并比较每次运行新增的招聘信息。
• **自由职业报价检查：**使用 /upwork/search 搜索某项技能，收集各招聘信息中的预算， 估算市场价格。

注意事项与限制

• **积分／成功后付费：**仅在返回 2xx 时计费；免费套餐每月提供 2,000 积分。 在 https://crawlora.net 获取密钥。
• 仅限公开数据——公开招聘信息／招聘板；请遵守各来源的条款。
• **安全性：**密钥仅保存在 CRAWLORA_API_KEY 中——切勿硬编码、放入查询参数或提交。
• ATS 招聘板需要公司的招聘板 slug，而非其公开品牌名称—— 如果你还不知道，请先使用 /jobs/company-search。
• 大多数 search／招聘板列表端点会对结果分页——传入 page 以遍历完整列表。