这是一个给京东运营同事使用的 Codex Skill。把商家 ID、店铺 ID 或 SKU 清单发给 Codex，它会在你本人已登录、且有权限访问的 yy.jd.com 页面中批量查询联系人、核验店铺身份，并输出整理好的 Excel 表或安全写回在线表格。
当前版本：1.1.0（更新日期 2026-09-30）。
- 接收直接粘贴的商家 ID。
- 接收
.xlsx、.csv、.tsv、.txt商家清单。 - 自动识别
商家ID、商家编号、venderId、vendorId等列名。 - 自动去重，同时保留原表来源行号。
- 一个联系人输出一行，保留手机、座机、邮箱、QQ 等字段。
- 输出
建联表和查询概览两个工作表。 - 按
店铺ID + 店铺名称精确核验身份后回填店铺链接，绝不混淆 shopId 和 venderId。 - 打开店铺前台，按完整商品标题判断主营类目并回填，不靠店名或导航猜类目。
- 在运营工作台批量回填店铺主营类目，导出新副本，不覆盖源表。
- 调用本地
webcli:ge批量回填 SKU 一至四级类目。 - 每次打开运营工作台查询前主动刷新一次任务自有后台页，等待表单加载完成，不碰正在使用的浏览器标签。
- 写回在线表格前先 dry-run 并请你确认精确范围和矩阵，写前重读身份和原值，单次执行后独立回读逐格核验；任何变化立即停止，不覆盖协作编辑。
你不需要安装 Python，不需要打开命令行，也不需要写代码。只要会给 Codex 发消息即可。
- 在 Windows 电脑上打开 Codex Desktop。
- 确认电脑能访问京东办公网络和
yy.jd.com。 - 用 Chrome 打开
http://yy.jd.com/vender/venderQuery。 - 如果页面要求登录，请本人完成登录。不要把密码、Cookie 或验证码发给任何人。
把下面整段话复制后发给 Codex：
请帮我从下面的 GitHub 仓库安装 Skill：
https://github.com/ctzlyj/jd-merchant-contact-batch-skill/tree/main/jd-merchant-contact-batch
请使用 skill-installer 完成安装。安装完成后告诉我，不要开始查询商家。
Codex 回复“安装完成”后，下一条消息就可以使用。一般不需要重启。
把下面模板中的示例编号换成自己的编号，再发给 Codex：
请使用 $jd-merchant-contact-batch 批量查询以下商家的联系人，并输出一份 Excel 建联表：
10000001
10000002
10000003
也可以连店铺名称一起粘贴：
请使用 $jd-merchant-contact-batch 查询下面这些商家，并输出 Excel 建联表：
| 店铺名称 | 店铺ID |
| --- | --- |
| 示例店铺甲 | 10000001 |
| 示例店铺乙 | 10000002 |
先把 Excel 拖进 Codex 对话框，然后发送：
请使用 $jd-merchant-contact-batch 读取我刚上传的表格，识别商家ID列，批量查询联系人，并输出 Excel 建联表。查询完成后告诉我成功、无联系人和失败的商家数量。
表格里有 店铺ID 和 店铺名称，想把官方店铺链接补到 店铺链接 列时，直接发送：
请使用 $jd-merchant-contact-batch 给我上传的表格回填店铺链接。要求：
1. 用「店铺ID + 店铺名称」精确核验身份；
2. 只填空的或错误的店铺链接，其他列原样保留；
3. 输出一个新的 Excel 副本，不要覆盖我的原表。
如果目标是 JoySpace 在线表格，再加一句“写回前先给我 dry-run 确认”。Codex 会先给出范围、行数和矩阵，等你确认后才写，写完再独立回读核验。
请使用 $jd-merchant-contact-batch 给我上传的店铺清单补充后台注册的主营类目（一、二级），输出新副本，不要覆盖原表。
Codex 会在运营工作台按 店铺ID + 店铺名称 批量查询，导出带 主营类目 / 一级主营类目 / 二级主营类目 / 类目查询状态 四列的新表格。
表格里有 SKU 列，想补齐一至四级类目时，发送：
请使用 $jd-merchant-contact-batch 给我上传的表格按 SKU 回填一至四级类目，输出新副本，不要覆盖原表。查询不到的 SKU 留空并告诉我数量。
- 提示需要控制 Chrome：点击允许。
- 提示未登录或登录失效：切换到 Chrome，本人完成登录，然后告诉 Codex“已经登录，请继续”。
- 提示没有权限：停止操作，联系系统管理员申请权限；不要让 Codex 绕过权限。
- 提示缺少运行组件：回复“允许安装这个 Skill 正常运行所需的依赖”。
- 部分商家没有联系人：这是正常结果，Excel 中会标记为“无联系人”。
- 提示源表已变化 / 请求缺少校验哈希：说明表格在生成请求后被动过。重新对最新表格执行一次即可，不要让它跳过校验。
- 提示输出文件已存在：让它换一个新文件名导出。这是防止覆盖旧交付的保护，不要删除旧文件。
- 提示店铺身份不一致或多条同名返回：这是身份保护，不要让它“选第一个”。先修正清单里的 ID 或店名再重跑。
- 在线表格写入前提示需要确认：打开它给的 dry-run 说明文件核对范围、行数和保留规则，确认无误回复“确认按这个矩阵写入”。范围、字段或内容变了就重新确认。
- 提示写入结果待核验：不要让它重试写入。它会先回读线上状态核对；你等它给出“已写入并核验一致”或“核验失败”的结论即可。
【京东商家联系方式批量查询使用方法】
一、先准备
1. 打开 Codex Desktop 和 Chrome。
2. 在 Chrome 打开：http://yy.jd.com/vender/venderQuery
3. 如果要求登录，请本人完成登录。
二、安装
把下面这句话发给 Codex：
请帮我从 https://github.com/ctzlyj/jd-merchant-contact-batch-skill/tree/main/jd-merchant-contact-batch 安装 Skill。请使用 skill-installer 完成安装，安装好后告诉我。
三、开始查询
安装完成后，把商家ID直接粘贴给 Codex，或者把包含商家ID的 Excel 拖进对话框，再发送：
请使用 $jd-merchant-contact-batch 批量查询这些商家的联系人，并输出一份 Excel 建联表。完成后告诉我成功、无联系人和失败的商家数量。
四、其他任务
回填店铺链接、补充店铺主营类目、按 SKU 补一至四级类目，也可以直接用一句话描述发给 Codex，例如：“给我上传的表格回填店铺链接，身份用店铺ID+店铺名称核验，输出新副本不要覆盖原表。”
五、如果 Codex 提示
- 需要控制 Chrome：点“允许”。
- 未登录：到 Chrome 完成登录，再回复“已经登录，请继续”。
- 没有权限：联系管理员，不要尝试绕过。
- 缺少依赖：回复“允许安装运行所需依赖”。
- 源表已变化或输出文件已存在：按提示重新生成请求或换新文件名，都是正常保护。
- 在线表格写入需要确认：核对 dry-run 文件后再回复“确认按这个矩阵写入”。
注意：不要把账号密码、Cookie、验证码或查询结果上传到公开网站。联系人信息只能用于经过授权的业务工作。
以后需要更新时，把下面这句话发给 Codex：
请把已安装的 jd-merchant-contact-batch Skill 更新为这个仓库的最新版本：
https://github.com/ctzlyj/jd-merchant-contact-batch-skill/tree/main/jd-merchant-contact-batch
如果 Codex 提示目标目录已存在，让它先备份旧版本，再安装新版本。
- 只查询用户明确提供的商家 ID，不猜测、不枚举相邻编号。
- 仅使用用户本人已有的登录态和业务权限。
- 不读取、导出或保存浏览器 Cookie、Token、密码和验证码。
- 遇到无权限、验证码、登录失效或持续限流时立即停止，不绕过安全控制。
- 联系人信息属于敏感业务数据，不要提交到 GitHub、网盘或公开聊天群。
jd-merchant-contact-batch-skill/
├── README.md
├── .githooks/pre-commit
└── jd-merchant-contact-batch/
├── SKILL.md
├── agents/openai.yaml
├── references/browser-query.md
├── references/joyspace-writeback.md
├── references/maintenance.md
├── references/storefront-screen.md
├── scripts/browser_query.js
├── scripts/contact_batch.py
├── scripts/scan_sensitive.py
├── scripts/shop_category.py
├── scripts/shop_screen.js
├── scripts/shop_screen.py
├── tests/test_browser_query.mjs
├── tests/test_contact_batch.py
├── tests/test_scan_sensitive.py
├── tests/test_shop_category.py
├── tests/test_shop_screen.mjs
├── tests/test_shop_screen.py
├── tests/test_shop_screen_identity.py
└── requirements.txt
cd jd-merchant-contact-batch
python -m pip install -r requirements.txt
python -m unittest discover -s tests -v
node tests/test_browser_query.mjs
node tests/test_shop_screen.mjs
python scripts/scan_sensitive.py
$env:PYTHONUTF8 = "1"
python "$env:CODEX_HOME\skills\.system\skill-creator\scripts\quick_validate.py" .提交前钩子（推荐）：在仓库根目录执行 git config core.hooksPath .githooks，之后每次 commit 会自动运行敏感数据扫描和全部回归测试。
本仓库不包含任何商家真实联系方式、账号凭据、Cookie 或查询结果。