Dataify Google Patents

使用此技能将用户对 Google Patents 的查询请求转换为 Dataify Scraper API 调用。

调用前必需的确认流程

每次实际发起 API 调用前，必须严格遵循以下确认流程。本流程优先级高于该技能中任何旧版工作流顺序。

1. 将用户的请求解析为 API 请求体（body）中的各字段，并固定设置 engine 值。
2. 仅在参数说明中**明确声明默认值**时才应用默认值。禁止将示例 YAML 值、样例提示、占位符值或示例（如 pizza、us、en、日期、机场代码、token 等）用作默认值。
3. 若某必需参数既无文档记载的默认值，又无法从用户请求中推断，则在构建参数表前主动向用户询问该参数。
4. 调用 API 前，须向用户展示一个 Markdown 表格。表格中**不得包含 Authorization 字段**；须完整列出本技能参考文档中定义的所有请求体字段（含 engine），即使当前值为空也需保留。
5. 表格必须严格包含以下四列：参数名、当前值、默认值、说明。
6. 表格展示后，须询问用户是否需要修改任一参数。**未获用户明确确认前，禁止调用 API。**
7. 若用户修改了任意参数，须重新生成表格并再次请求确认。
8. 若缺失 token，立即中止流程，并告知用户前往 Dataify Dashboard 登录以获取 DATAIFY_API_TOKEN。

尽可能使用内置的预览辅助工具，根据本技能的参考文档自动生成确认表格：

python3 scripts/preview_params.py --params-json '{"q":"USER_QUERY"}'

请将所有已解析的当前值通过 --params-json 或匹配的 --field value 参数传入 preview_params.py。该辅助工具从 references/*api.md 中读取默认值与说明；若其无法解析某字段的默认值，请留空该字段的“默认值”列，**切勿自行编造**。

9. 完成用户确认及 token 处理后，使用 python3 执行内置 Python 脚本，并**直接返回 API 响应体原始内容**，不得进行摘要、提取、清洗、翻译或结构化处理。

工作流

1. 将用户的请求解析为 Dataify Google Patents 对应的字段。始终将 engine 设为 google_patents。
2. 仅应用参数说明中**明确定义**的默认值：
   • json: "1"
   • page: "0"
   • dups: "family"
   • patents: "true"
   • scholar: "false"
   • no_cache: "false"
   • sort 字段默认按相关性排序，即**省略该字段**。
3. 禁止使用示例值作为默认值。对于无文档默认值的可选字段，除非用户明确要求，否则一律省略。
4. 若缺失 token，立即中止流程，并告知用户前往 Dataify Dashboard 登录以获取 DATAIFY_API_TOKEN。
5. 每次 API 调用前，均须运行内置 Python 脚本并传入 --print-table 参数，以生成完整的参数审查表格：

python3 scripts/google_patents.py --request "search Google Patents for battery recycling patents" --print-table

向用户展示该表格，列名必须严格为：参数名、当前值、默认值、说明。随后询问用户是否需要修改任一参数。**未获用户明确确认前，禁止调用 API。**

6. 若用户修改了参数，请通过显式标志（如 --q）或 --params-json 传入编辑后的值，重新生成并展示表格，并再次请求确认。
7. 确认无误后，执行不带 --print-table 的脚本调用：

python3 scripts/google_patents.py --request "search Google Patents for battery recycling patents"

对于多数字段，推荐传入一个经 shell 合适转义的 JSON 对象：

python3 scripts/google_patents.py --params-json '{"q":"battery recycling","status":"GRANT","country":"US","json":"1"}'

若用户在对话中直接提供了 token（而非通过环境变量），请使用 --token 参数传入，并确保最终响应中**不回显该 token**：

python3 scripts/google_patents.py --token "USER_TOKEN" --q "battery recycling"

8. 将脚本输出**原样返回**给用户。不得对 API 响应内容进行摘要、提取、清洗、翻译或结构调整。

字段映射规则

当需要查阅准确的字段列表、默认值、可接受值及映射提示时，请参考 references/google_patents_api.md。

核心规则：

• API 请求必须以表单数据（form data）形式提交，Content-Type 必须为 application/x-www-form-urlencoded。
• 始终使用 UTF-8 编码。
• engine 字段必须强制设为 google_patents；忽略用户可能提供的任何冲突 engine 值。
• 请求值一律保持字符串类型，除非脚本明确支持并能自动标准化布尔值。
• 若无法从用户请求中推断出有意义的搜索关键词或筛选条件，须主动发起追问。
• 脚本内自动标准化 token 值：不含 Bearer 前缀的 token 将被自动补全前缀。
• 参数审查表格中**不得显示完整 token**。

常见映射关系：

• "JSON" → json: "1"
• "JSON+HTML" → json: "2"
• "HTML" → json: "3"
• "Light JSON" → json: "4"
• 第一页 → page: "0"，第二页 → page: "1"
• 最新/最近/最新发布 → sort: "new"
• 最旧/最早 → sort: "old"
• 相关性排序/默认排序 → **省略 sort 字段**
• 分组/聚类结果 → clustered: "true"
• 同族去重 → dups: "family"
• 公开文本去重 → dups: "language"
• 包含专利结果 → patents: "true"
• 包含 Google Scholar 结果 → scholar: "true"
• 早于/晚于日期 → 使用 before 或 after 字段，格式为 priority:YYYYMMDD、filing:YYYYMMDD 或 publication:YYYYMMDD
• 发明人姓名 → inventor
• 受让人/申请人/所有权人姓名 → assignee
• 国家/地区专利代码 → country
• 结果语言筛选 → language
• 已授权专利 → status: "GRANT"
• 申请中专利 → status: "APPLICATION"
• 发明专利 → type: "PATENT"
• 外观设计专利 → type: "DESIGN"
• 涉及诉讼（是/否）→ litigation: "YES" 或 litigation: "NO"
• 绕过缓存 → no_cache: "true"