用途：通过 freehire.me 的公开 JSON API 搜索实时技术职位（软件、数据、工程等），支持多国家、多市场及远程岗位。freehire.me 是开源 IT 招聘聚合器，将约 50 个 ATS 平台的职位统一为同一 schema。
主要能力：按关键词搜索；按地区（--region）、国家（--country）、城市（--city）、资历（--seniority）、类别（--category）、技能（--skill）、公司（--company）、远程模式（--remote）及发布时间（--jobage）等结构化 facet 筛选；搜索结果自带完整职位描述，无需逐条跟进；可用 slug 查询单个职位详情（含已关闭职位）。
使用方式：无需认证或 API 密钥，仅需 bun。搜索命令：bun run .agents/skills/freehire-search/cli/src/cli.ts search [-q "<keywords>"] [facet flags]；详情命令：bun run .agents/skills/freehire-search/cli/src/cli.ts detail <slug|url>。支持 --format json|table|plain，默认 json；--description-format markdown|text|html。可通过环境变量 FREEHIRE_API_URL 指向自托管实例（默认 https://freehire.me）。facet 值来自受控词表，可用 /api/v1/jobs/facets 查看实时值。
适用场景：技术类职位搜索与筛选，如按资历、类别、技能、地区或远程模式查找岗位，或按 slug 查看单个职位完整详情。
限制：目前聚焦技术类职位，非技术覆盖尚不成熟；依赖第三方托管服务 freehire.me，为尽力而为、无 SLA，API 不可达时 CLI 以非零退出并报错；地理等 facet 可能不完整，缺失表示“未解析”而非“不适用”，可用 --region none 匹配未解析地区；仅支持搜索与详情，不涉及用户追踪功能。