x49 专利检索

要解决的问题

专利检索常见的三个坑：靠网页拼结果，字段口径不统一、难以自动化；申请人名称变体多，纯文本查询容易漏检或误纳；legal_status、document_type 和 kind_code 混用，结论容易跑偏。这个技能把流程收敛到单一开发者 API，用同一套规则完成查询构造、字段选择和结果解读。

技能如何工作

• 数据源唯一：以 https://patents.x49.ai 的 /api/developer/v1 为准，请求带 Authorization: Bearer 或 X-API-Key 头。
• 先小后大：搜索默认 limit=20，先拿摘要级字段（publication_number、title、publication_date、assignees），命中后再按公开号拉详情、引用或法律事件。
• 结构化筛选优先：申请人模糊时先用 /filter_values?facet=applicant 取规范值；日期给到月或年就展开成 YYYY-MM-DD 全区间；地区用 US/EP/WO/CN 短码。
• 按意图选端点：已知公开号直接 GET /patent/{publication_number}；2-20 条用 POST /patents/batch；超过 20 条走异步 job，从 job.result.results[] 读取。
• 口径分离：document_type 只取 Application、Granted Patent、Other，不用 A/B/B1 kind code；legal_status 与返回的 status 标签分开记录。
• 错误按结构处理：invalid_query 等看 error.message 修请求；rate_limit_exceeded 尊重 Retry-After；临时 5xx 保留 X-Request-Id 重试。

适用边界

• 只返回结构化专利数据，不推断法律结论、权属关系、产品路线或商业意图。
• 公开试用 key 配额有限（多数端点 60 秒 6000 次，PDF 下载 60 秒 50 次），批量任务建议申请私有 key。
• 搜索单次最多 100 条，不暴露前端分页；多条件查询无结果时按 facet → 日期 → 地区 → 文书类型逐项放宽，并在回答中说明放宽范围。
• 返回的是原始语言专利数据，不承诺界面翻译；PDF 和图片默认只出元数据，用户明确要文件时才调 /download 或 /image/...。