SKILL.md
ICP 批处理工作流
此技能封装了整套批量查询流程，适用于类似 domains.xlsx 的表格：
- 从表头含“链接”的列提取域名（保留去重，非标准值也保留）。
- 优先使用本地缓存
icp_results.csv；仅对缺失或失败记录调用 API。 - 写回/更新：
- icpresults.csv：完整原始响应缓存（domain,statuscode,errorheader,body）。 - icpsuccess.csv：解析后的成功条目（code=1）。 - 原始 Excel 在末尾追加两列：备案主体、备案号。
运行前准备
- Python 3.9+，依赖：
pip install openpyxl requests。 - AppCode 可通过环境变量、
--appcode、或appcode.txt（同目录一行内容）提供；未提供会提示输入。 - 默认文件：
domains.xlsx，若找不到会弹出文件选择器；执行过程中会显示进度与错误提示。
快速使用
python icp-batch-skill/scripts/run_icp_batch.py \
--workbook domains.xlsx \
--cache icp_results.csv \
--success icp_success.csv参数说明（均有默认，可省略）：
--workbook：待处理 Excel（默认 domains.xlsx）。--cache：缓存文件（默认 icp_results.csv）。--success：成功解析输出（默认 icp_success.csv）。
过程要点
- 提取域名：优先匹配表头等于“链接”的列，否则使用首列。对每行提取正则域名；无匹配则使用原文本。
- 缓存策略：
- 命中且 statuscode=200 且响应 code=1 → 直接复用。 - 其他情况 → 调用 API GET https://domainicp.market.alicloudapi.com/do?domain=...，头 Authorization: APPCODE <APPCODE>。
- 写回：
- 追加两列表头：备案主体、备案号，按行填充命中数据（无则留空）。 - icpresults.csv 覆盖写入完整域名顺序。 - icpsuccess.csv 写入成功解析条目，便于后续复用。
常见问题
- 403/鉴权失败：检查 APP_CODE 是否有效、套餐授权正常。
- 非标准域名：脚本保留并尝试查询，若返回 code=0 / 字段为空，输出空。
- 如需更换 API Host/Path，可用参数
--host、--path（见脚本）。
资源
- 脚本：
scripts/runicpbatch.py