n8n把WooCommerce商品增量索引进Pinecone

原文要点

这是一个免费的n8n模板，手动触发或每天凌晨3点运行：分页拉取WooCommerce全部已发布商品的ID和修改时间，与名为indexed_wc_products_v8的n8n数据表中已索引记录比对，只挑新增或有改动的一批商品批量取详情；逐个商品补充变体信息和最多10条评论，拼成干净文本后先按fileId删除Pinecone中的旧向量防重复，再分块生成OpenAI嵌入写入配置的命名空间；同时把商品最新修改时间写回数据表，并删除WooCommerce中已不存在商品的向量和表记录。需要WooCommerce REST API、Pinecone、OpenAI三组凭据。

这次做成什么

搭一条“商品库→向量索引”的增量同步管道，并用一个只有几个商品的测试店铺验证：新增商品入库、修改后重索引、下架后向量被清理这三种行为。

准备什么

• 一个有REST API读写权限的WooCommerce测试店铺及Consumer Key/Secret
• Pinecone账号，已创建一个维度与所用嵌入模型匹配的索引，拿到index host
• OpenAI API密钥用于生成嵌入，会产生费用
• n8n实例（版本需支持Data Table功能）并能导入该免费模板

具体怎么做

1. 准备Pinecone索引和数据表

   在Pinecone控制台建一个索引（若用text-embedding-3-small则维度1536），记录index name、index host和要用的namespace（如products）。在n8n中新建Data Table，命名为indexed_wc_products_v8（与模板默认一致），加productId和dateModified两列。

2. 配置模板设置值

   导入工作流20139后打开设置值节点：填入店铺base URL（如https://demo-store.example.com）、Pinecone的index name、index host、namespace；productBatchSize先设小值如5便于观察；确认调度是手动触发还是每天03:00。

3. 连接三个凭据

   新建WooCommerce API凭据（填Consumer Key/Secret并验证能调通REST API）、Pinecone API凭据、OpenAI凭据，分别挂到对应节点。模板中嵌入模型名以模板内配置为准，本站未逐项核对，导入后在OpenAI节点确认一次。

4. 造三种测试商品并首跑

   在测试店铺建3个已发布商品：1个简单商品、1个含2个变体的可变商品、1个有3条评论的商品。手动执行工作流，确认批量取详情、逐商品补变体和评论、删旧向量、分块嵌入、写入Pinecone、回写数据表各环节成功。

5. 验证增量与删除

   第二次跑前把其中一个商品的描述改一句话、把另一个商品移到回收站。再执行一次：被修改的商品应因dateModified变化被重新索引（先删旧向量再写新向量），被删除商品的Pinecone向量和数据表记录应被清除，未改动的商品不应重复处理。

可直接复制的材料

Title: 有机棉基础T恤
Description: 100%有机棉，220g面料，圆领短袖，适合日常穿着。
Price: 199 INR
Variants: 尺码 S/M/L，颜色 白色/藏青
Reviews: 面料舒服尺码标准 | 洗后没有缩水 | 物流稍慢但质量不错

product_id,name,type,expected
101,有机棉基础T恤,simple,首次运行入库
102,手工陶瓷马克杯,variable(S/M两变体),含变体文本入库
103,帆布托特包,simple+3条评论,评论进入嵌入文本

操作,数据表dateModified,Pinecone向量
新增商品,插入新行,写入新向量
修改商品描述,更新为最新时间,按fileId先删后写
商品下架,删除该行,删除对应fileId向量
无改动,不变,不处理

输入与输出示例

本站虚构演示，按模板逻辑推演，非实际运行记录

输入

测试店铺有商品101（简单T恤，dateModified为2026-09-29T08:00:00）已索引；运行前把102号马克杯标题从“马克杯”改为“手工陶瓷马克杯”，并把103号托特包移入回收站。

对应输出

本次运行只处理102：先删除Pinecone中fileId对应102的旧向量，分块写入新标题的嵌入；数据表中102的dateModified更新。103的数据表行和向量被删除。101未改动，本次不产生任何WooCommerce详情请求和嵌入调用。

做完检查这些

• 数据表indexed_wc_products_v8中每个已发布商品有且仅有一行，productId不重复
• 重复运行且无任何商品变更时，WooCommerce详情请求数和OpenAI嵌入调用数为零
• 修改某商品后重跑，Pinecone中该fileId只有一组新向量，不存在新旧两份
• 商品下架后其向量与数据表记录均被清除，店铺语义搜索不再命中该商品

容易卡住的地方

• Pinecone索引维度必须与嵌入模型输出维度一致，维度不符会在写入节点报错
• 模板默认凌晨3点运行基于n8n实例时区，自托管需确认时区
• 可变商品的变体和评论是逐个商品请求的，商品多时单次运行耗时和API调用量上升，productBatchSize别一开始设太大
• 数据表名称必须和模板引用一致，改名后所有Data Table节点都要同步改
• 嵌入和删除顺序依赖fileId约定，fileId字段名以模板节点实际配置为准，导入后先核对