小红书关键词筛选器

把一份文件或一个文件夹中的小红书聚光关键词 Excel/CSV，整理成可追溯的合并去重表和用户指定数量的排序结果。筛选必须同时考虑产品承接、外贸老板搜索可能性、搜索意图、人工样本和平台数据。

运行筛选

1. 先检查用户是否明确写出本次需要的关键词数量。若没有，必须暂停执行并询问：“这次需要筛选出多少个关键词？”取得明确的正整数后再运行；若用户已经明确数量，不重复询问。

2. 确认输入只包含用户指定的 .xlsx 或 .csv；不读取网页、不登录广告平台，也不创建或修改广告。

3. 使用 Codex 提供的工作区依赖。运行：

   powershell -ExecutionPolicy Bypass -File "<skill目录>\scripts\run_filter.ps1" -InputPath "<Excel文件或文件夹>" -MaxResults <用户确认的数量> -OutputRoot "<结果目录>"
   

   OutputRoot 可省略；默认在输入位置的同级目录创建“关键词筛选结果”。

4. 程序不得修改输入文件。输出包括合并去重表、指定数量的筛选结果和运行摘要。若合格候选不足，应按实际数量输出并明确告知用户，不得用不相关词补足。

5. 运行后按电子表格工作流检查关键工作表、错误值和视觉可读性。可在同一个临时 node_modules 连接存在时调用 scripts/verify_result.mjs <工作簿> <预览目录>。再向用户报告输入文件数、原始行数、去重数、合格候选数、用户要求数量和最终实际数量。

判断原则

• 关键词本身必须能被 Kingsway 或外贸龙虾承接；来源词根只能追溯，不能证明相关。
• 先排除无关行业、软件故障、娱乐人物及明确负样本，再判断外贸老板是否会搜索。
• 搜索意图分为购买/选型、比较/评估、了解/解决问题、导航；意图强不能覆盖业务不相关。
• WhatsApp 的客户开发、询盘、跟进和话术场景优先；Google Map 最多 1 条，VK 当前不进入最终结果。
• 自动驾驶、无人驾驶、智能驾驶、辅助驾驶、自动泊车和智驾系统属于汽车技术，直接淘汰。
• 完整口径见 筛选标准。修改词典或渠道配额前再读 规则维护。

修改规则

只有用户明确要求调整筛选标准时才修改配置。编辑：

• scripts/engine/keyword_auto_filter/config/top50_standard.json：目标人群、业务主题、渠道配额、排序参数和产品核心词。
• scripts/engine/keyword_auto_filter/config/rules.json：明确硬黑名单和条件黑名单。

保持 JSON 有效；用户若说“这次不用测试”，只改规则与说明，不运行筛选。不要因单个误判无限扩张黑名单，应抽象成边界清楚的业务类别。

吸收人工审核

仅在用户明确要求学习人工结论时运行：

powershell -ExecutionPolicy Bypass -File "<skill目录>\scripts\run_absorb_review.ps1" -WorkbookPath "<人工审核后的结果表>"

Excel/CSV 需同时含“关键词”列，以及“最终人工结论”“人工审核”“人工结论”“最终结论”或“人工复核”列；只有值为“保留”或“淘汰”的行会被吸收。脚本先备份旧样本，不改变审核文件。

解释结果

需要解释某个词时，从“全部判断结果”读取业务门槛、老板搜索可能性、搜索意图、业务主题和淘汰说明。说明具体命中了哪条规则，不把搜索量或出价当成相关性的替代品。