京东联盟自动化转链工具：PID、API签名与批量转发实战

简介京东京粉鲸鱼转链转发工具是一款面向京东联盟推广者的群发转链辅助软件覆盖自动发单、批量转发、联盟配置等核心环节帮助用户从重复机械操作中解脱出来。压缩包共15个文件大小约129.5MB包含dll动态库、exe可执行程序、json配置文件、html内置界面及gif演示文件其中dll动态库和exe主程序保障核心功能运行json用于规则配置gif可辅助快速上手压缩包内还附带了微信3.1.0安装包避免版本不兼容问题。目前已有512人学习下载。软件支持定时自动发单与多群批量转发可灵活配置京东联盟推广位ID提供转发规则、替换词、前后缀消息、屏蔽词等模式同时支持登录多个微信适合运营社群、需要多账号并行的联盟推手使用能够显著提升日常发单效率。1. 群消息里的京东链接手动转链太慢让工具替你完成重复动作做京东联盟推广的人手机里至少躺着四五个带货群。群里每天飘过几十条商品链接别人甩过来的是不带你的PID的普通链接你直接转发出去佣金一分都拿不到。正确的做法是把链接复制进联盟后台点转链生成带你自己推广位参数的短链再贴回群里。一天几十条链接来回切换至少耗掉一个小时而且漏转一条就少一笔佣金。鲸鱼转链转发工具解决的就是这件事把「复制链接、进后台、转链、回群发」这四步压成一步监听到群里出现京东链接后自动完成转链再发回群里或者把一批链接批量丢进去一次吐出一批带参短链。适合每天要处理几十上百条链接、靠走量赚佣金的人。2. 转链工具的核心机制PID 三段式与佣金归属的底层逻辑2.1 PID 三段式结构联盟ID、推广者ID、站点ID各管什么先用大白话讲清楚转链到底在转什么。你在京东联盟后台能看到一串由三组数字组成的标识格式是「联盟ID-推广者ID-站点ID」中间用短横线隔开。比如某个推广者的PID是100123456-789012-345678第一段代表你加入联盟时的唯一账号标识第二段是具体的推广者第三段是推广位也就是链接最终落在哪个渠道上。佣金结算的时候京东联盟按这串字符串定位到具体推广者把订单佣金打到对应账号。这串 PID 之所以重要是因为它决定了链接的「归属权」。你转链做的事本质上是把一条无归属的普通商品链接替换成一条带你这串 PID 参数的推广链接。京东联盟的服务端收到用户点击后通过链接里携带的 PID 参数回写归属关系——用户从这条链接点进去并下单佣金就记在你的名下。如果链接里没有 PID或者 PID 是别人的那这笔订单就算出了爆款也跟你没关系。很多新手在配置工具时最容易搞混的是第三段「站点ID」。同一个推广者名下可以创建多个推广位PC站的推广位、移动端的推广位、社群的推广位都对应不同的站点ID。转链表单在联盟后台查询时是按推广位区分的站点ID从1开始按顺序排不是unionId也不是userId。有人把「账号ID」当成「站点ID」填进工具转出来的链接佣金照样会丢后面避坑章会专门说这件事。2.2 转链 API 在做什么一次请求把普通链接变成带参短链鲸鱼工具能把这套操作自动化靠的是京东联盟开放平台提供的转链接口。工具把你的 PID、AppKey、AppSecret 封装成请求发给联盟服务端服务端校验身份后返回一条新的短链接这条新链接里的参数已经被替换成了你的推广位信息。整个转链过程大概几百毫秒比手速快得多。接口的核心参数一般是这几个materialId要转链的商品链接或商品 IDsiteIdPID 第三段也就是推广位 IDpositionId推广位下的子位置通常填 1 或留空pid完整的推广标识字符串请求还需要带上appKey和appSecret生成的签名sign。签名算法一般是把参数按字典序排列后拼接appSecret做 MD5再转大写。很多工具配置失败都是签名这一步出的错——参数名的大小写不一致或者某个空参数也被拼进签名串里导致服务端返回401。下面贴一段我在本地验证过逻辑的示意代码不是工具内部实现但能帮你理解转链请求长什么样import hashlib import requests import time def generate_sign(params: dict, app_secret: str) - str: # 签名规则参数按 key 字典序排列拼接 secret 后做 MD5转大写 keys sorted(params.keys()) raw_string .join(f{k}{params[k]} for k in keys) app_secret return hashlib.md5(raw_string.encode(utf-8)).hexdigest().upper() def convert_link(material_id: str, pid: str, app_key: str, app_secret: str) - str: site_id pid.split(-)[2] # PID 第三段是站点ID params { appKey: app_key, method: jd.union.open.promotion.common.get, promotionCodeType: 1, # 1 表示转链推广 materialId: material_id, # 商品链接或商品ID siteId: site_id, positionId: 1, timestamp: str(int(time.time() * 1000)) } params[sign] generate_sign(params, app_secret) resp requests.post(https://api.jd.com/routerjson, dataparams, timeout10) return resp.json()[jd_union_open_promotion_common_get_response][data][shortURL]上面这段的逻辑要点有三个第一generate_sign里拼接顺序错了就是401调接口第一件事永远是检查签名串第二siteId是从 PID 里解析出来的不能自己编一个数字填进去第三promotionCodeType固定为1表示通用转链改别的值会走不同业务逻辑。工具内置的转链模块本质就是把这段逻辑包了一层壳你填好配置后它替你发请求。2.3 工具的自动化设计监听模式与手动批量模式的差异明白转链 API 的机制后鲸鱼工具的设计思路就很好理解了。它内部封装了两条使用路径第一种是「监听转发」模式。工具运行后挂在你指定的聊天群/会话窗口后面盯住新出现的消息文本。一旦检测到item.jd.com、u.jd.com、3.cn这些京东链接特征串就提取整条链接调用上一节说的转链接口把生成的带参短链包装成一条新消息按你预设的格式发回群里。整个过程从检测到发出大概一两秒群里其他人感知不到延迟。第二种是「手动批量」模式。你把一批商品链接复制到文本文件里每行一条或者直接粘贴到工具输入框工具逐行读取批量调用转链接口最后把结果输出成一个新文件。每条链接之间可以附加自定义前缀或后缀文字比如「今日好物推荐」之类的固定话术。这种模式适合做营销素材一次处理二三十条链接然后自己挑着发。两种模式的区别在于触发方式不同底层用的都是同一个转链接口。实际使用中大部分人两个模式混着用日常挂监听转发活动大促前跑一波批量转链囤素材。工具的配置项里还有一个关键开关叫「去重间隔」默认是 60 秒内同一个链接不重复转链防止微信群有人连续刷同一条商品导致短链堆积。这个值我一般调成 300毕竟同一条链接短时间内发两遍群里看着也烦。3. 部署前的三个准备账号、应用密钥与 PID 配置3.1 京东联盟账号与开放平台应用创建工具跑起来之前得先把联盟推广账号和 API 调用凭证准备好。如果你平时在联盟后台手动转链都是正常操作的说明账号已经有了这步只差开放平台的应用创建。登录京东联盟开放平台后进入「我的应用」页面新建一个应用类型选「自研应用」就行。创建完成后页面会给你两个关键值AppKey和AppSecret。AppKey 是公开标识AppSecret 相当于密码调用接口时用这两个值加参数列表做签名联盟服务端才能确认请求方身份。这块有个容易忽略的点开放平台不直接给你 API 权限创建应用后需要单独申请「商品推广」接口权限。申请路径一般在应用详情页的「接口权限」里找到推广转链接口点申请类型选「通用转链」。审批通常是自动化的秒通过。如果接口权限没开通工具调用时会一直报「无接口权限」很多人卡在这一步还以为是配置文件写错了。3.2 获取 PID 与 API 密钥几个配置项的逐一说明打开联盟后台的「推广管理」「推广位管理」能看到你名下所有推广位每条记录有完整的 PID 字符串。新建推广位时类型选「社交媒体」或「自定义推广位」媒体名称随便填个自己能记住的名字就行PID 会替你自动生成。工具的配置界面里有四个字段属于必填项下面逐个说明配置项填什么容易踩的坑AppKey开放平台应用里的 AppKey和账号登录名混淆AppKey 是一长串字母数字AppSecret开放平台应用里的 AppSecret复制时多带空格签名永远对不上PID推广位管理里的完整 PID三段都用短横线连好只填了后半段站点ID导致佣金归属错误转链接口权限应用详情里确认已开通没开通时请求直接报权限错误AppSecret 在页面上一般有「查看」按钮点击后可能还要二次验证身份。复制出来后如果工具提示签名错误先检查配置里有没有首尾空格这个细节我遇到过不下五次。PID 则建议直接从推广位管理页面复制完整字符串不要自己手打三段式结构中间的数字串容易抄错。3.3 配置文件格式说明以 JSON 为例工具支持通过界面配置也支持直接编辑配置文件。配置文件通常是 JSON 格式长这样{ app_key: a1b2c3d4e5f6g7h8i9j0, app_secret: 0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d, pid: 100123456-789012-345678, monitor_mode: { enabled: true, target_group_id: 群ID占位, dedup_interval_seconds: 300, auto_reply_prefix: 【今日好物】, watch_keywords: [京东, https://item.jd.com, u.jd.com] }, batch_mode: { input_file: links.txt, output_file: converted_links.txt, line_prefix: }, api_timeout_seconds: 10, retry_on_fail: 3 }各字段的意思在键名上已经很直观我说几个影响实际运行效果的参数。dedup_interval_seconds是去重窗口同一个链接在这个时间窗内只转链一次设太短会频繁打接口设太长又有可能漏掉群里正常重发的商品。watch_keywords是链接特征词列表工具检测到这些关键词才触发转链可以稍微多写几个避免商品链接被特殊字符截断导致漏检测。retry_on_fail是接口失败重试次数网络抖动时重试两次能救回来但不要设到 5 以上接口限频会被拉黑。配置文件改完后工具启动时会做一次自检校验 AppKey、AppSecret、PID 三段是否齐全然后调一次转链测试接口。自检通过会提示「配置 OK」失败会给出具体是哪一项出了问题。4. 实战把工具挂到群里从批量转链到自动转发4.1 启动前检查清单配置填完之后不要立刻开监听先花两分钟过一遍检查清单。首先确认 PID 里的三段数字从后台复制出来没被截断我见过有人在微信里转发 PID 字符串时把中间短横线变成了省略号工具解析直接失败。其次确认开放平台接口权限状态是「已开通」不是「申请中」。最后确认电脑或手机上的网络环境能正常访问联盟 API 服务器部分地区网络对 API 域名解析会比较慢工具卡在「请求超时」基本都是这个原因。以上三项都通过后先用批量模式做一次单条链接的转链测试。拿一条自己店铺或任意商品链接放进输入文件跑一次看输出文件里是否生成了新的短链。打开短链确认能够正常跳转到商品页面并且链接后缀带上了union_promotion字样这就说明整套链路是通的。4.2 批量转链输入文件格式与字段匹配批量模式的核心是输入文件格式要严格对齐。工具默认按行读取每行一条链接多余的空行会被跳过但链接本身不允许包含空格或换行。我一般这样准备输入文件# 准备待转链的链接列表每行一个 cat links.txt EOF https://item.jd.com/100012345.html https://u.jd.com/abcdefg https://item.jd.com/100067890.html EOF # 运行工具的批量转换命令不同版本命令略有差异以实际为准 jdlink-tool batch -i links.txt -o converted_links.txt --pid 100123456-789012-345678输出文件里每行对应一条转链后的短链顺序和输入文件一致。如果某条链接转链失败工具会在对应的输出行里写ERROR而不是短链方便你回看是哪一条出了问题。跑完批量后我习惯把convert_links.txt用文本编辑器打开检查一遍尾部看有没有ERROR标记有的话单独处理那几条不阻塞正常批次发布。批量模式有两个参数值得说。第一个是--line-prefix会在转换结果每行前面加自定义文字比如「今日精选」这样导出的文件直接能粘贴到发布平台不用再手动编辑。第二个是--concurrency控制并发转链的线程数默认是 1串行。串行最稳几十条链接也就几十秒。并发调到 3 能快点但接口限频的风险随之上升一般个人用串行就够了。4.3 群内自动转发模式参数设置与白名单自动转发是鲸鱼工具的核心卖点使用前要先把两个关键参数设好监听目标群和白名单规则。监听目标群指定工具要挂靠的群会话一般通过群名称或群 ID 指定。工具内置了群列表读取功能启动监听后它会枚举当前会话列表匹配名字包含你指定关键词的群。注意匹配是模糊匹配还是精确匹配模糊匹配容易误监听到群名差不多的其他群我建议指定完整群名。白名单规则的作用是控制「哪些链接可以转」。默认是全部转但群消息里时常混入别人发的其他平台链接或者京东链接里夹带有干扰参数。白名单有两种写法一种是指定允许的商品类目 ID另一种是指定发起转链的人群。类目过滤适合你主营某个垂直品类比如数码或母婴可以把其他品类的链接全部挡掉省接口请求人群白名单则是只转某几个群友发出来的链接防止有人在群里恶意刷链接消耗你的转链次数。这块设计因人而异没有标准答案但过滤规则加得越严工具误触发越少跑起来越安静。4.4 运行日志怎么看正常与异常状态的判断标准工具跑起来以后日志是判断它是否正常工作的唯一窗口。打开日志面板正常情况下每一两分钟会刷出几行类似这样的信息[2025-06-10 14:23:01] [INFO] 监听群好物分享群新消息 [2025-06-10 14:23:02] [DETECT] 检测到京东链接: https://item.jd.com/100012345.html [2025-06-10 14:23:02] [INFO] 调用转链接口... [2025-06-10 14:23:03] [SUCCESS] 转链成功: https://union.jd.com/xyz123 [2025-06-10 14:23:03] [INFO] 消息已发送到群好物分享群四行日志对应一个完整处理闭环收到消息、识别出链接、转链接口成功、消息已回发。如果最后一步显示[SEND_FAIL]说明你本地登录的聊天客户端状态异常多半是掉线或者被限制登录检查客户端登录状态即可。如果显示[API_LIMIT]说明接口被限频了工具会自动暂停一段时间再继续日志里会给出暂停秒数不用手动干预。日志文件默认保存在工具目录下的logs文件夹里按天滚动。排查历史问题时要打开对应日期的文件搜索ERROR或WARN级别记录不要只看终端面板。很多偶发性问题比如某一次请求超时导致单条链接漏转在日志里都能找到对应时间点的异常记录。5. 避坑佣金丢失、限频封禁与链接失效的排查手册5.1 转链成功但订单佣金看不清PID 选错推广位现象工具转链一切正常短链能打开、商品能下单但联盟后台的订单明细里找不到这笔佣金记录或者佣金金额为 0。原因工具配置里填的 PID 与你实际要在后台查佣金的推广位不一致。最常见的是填了同一个联盟 ID 下另一个闲置推广位的 PID订单落到那个推广位上了而你看的是当前活跃推广位的报表。还有一种情况是站点 ID 填错了比如 PID 第三段写成了1但那个推广位实际不是你常用的。解决打开联盟后台「推广管理」→「推广位管理」确认你实际要使用的推广位 ID 是哪一个把工具配置里的 PID 完整替换成那个推广位的完整字符串。替换后重新发起一次转链在联盟后台「订单明细」里按新 PID 过滤连续下一笔小额测试单验证归属关系正确后再正常使用。5.2 工具频繁提示「请求频率过高」现象工具跑着跑着开始报[API_LIMIT]每次报错后会暂停几十秒甚至几分钟转链效率骤降。原因京东联盟 API 对每个 AppKey 有调用频率限制每秒调用次数QPS上限一般很低。监听模式下如果群里短时间内突然涌入多条含京东链接的消息工具会连续发起多个并发请求瞬间打满 QPS 配额触发限频保护机制。解决把配置文件里的concurrency调回 1也就是串行处理。监听模式下每次只处理一条链接处理完再取下一条。如果串行还是报限频说明同时有多个设备共用同一个 AppKey检查一下是否其他程序也在调用同一个应用的接口。我给自己的定位是「一台设备一个 AppKey」绝不跨设备共用。5.3 转链成功率高但真正能用的链接少现象工具把链接转过来了但发出去的短链打开后提示「商品已下架」或「活动已结束」用户点进去是空页面。原因转链接口只负责替换链接参数不校验商品当前是否在售。群里流转的商品链接非常有时效性特别是活动促销群发的链接活动结束商品下架后链接本身不再有效但转链请求依然会返回一个「转链成功」的短链外壳。这是平台机制决定的接口层不会拦截失效商品。解决批量模式跑完后抽样打开 35 条短链确认商品页面正常。如果抽到失效商品的比例超过三成说明这批链接来源质量不行不必全部重转直接放弃这批素材更省时间。监听模式下可以在白名单里加一层「类目过滤」只转你确定活跃度高的品类链接减少无效转链的占比。5.4 群里出现重复商品短链被群友认为是机器人刷屏现象同一个商品链接在短时间内在群里出现两次第二次是本工具监听到群友又发了一遍该链接自动又转了一次并回发导致群里同一个商品前后出现两条转链消息。原因去重时间窗口设置太短。默认的dedup_interval_seconds是 60 秒但很多群里的消息间隔并没有那么紧凑群友隔几分钟重发同一条商品链接是常态。解决把去重窗口调到 600 秒10 分钟甚至更长。设置时要从群活跃度出发大促期间群里消息刷得快窗口短一点没关系日常运营的群窗口至少 10 分钟起步。这个值是工程经验值没有绝对正确多观察自己群的活跃节奏再定。5.5 配置文件修改后工具不生效现象在配置文件里手动改了 PID 或 AppSecret保存后重启工具发现转链结果还是旧配置。原因工具启动时会一次性读取配置文件到内存修改文件后如果没有通过工具界面触发「重新加载配置」内存里的配置不会自动刷新。有些版本甚至要求配置文件编码必须是 UTF-8 无 BOM用记事本另存的 UTF-8 带 BOM 文件会导致解析失败工具回退到默认配置。解决修改配置后在工具界面找到「重载配置」按钮或者完全退出工具进程再重新启动。不要只关闭主窗口要确认进程管理里没有残留进程——很多工具关闭主窗口后最小化到托盘进程还活着配置文件改了也没用。检查文件编码时用代码编辑器比如 VS Code另存为「UTF-8」即可。6. 进阶技巧多账号轮换、关键词过滤与定时任务6.1 多账号轮换降低限频风险当单账号的 API 调用量持续偏高时限频会成为常态。我一般把多个联盟账号配进工具里开启「账号轮换」模式。工具在每次调用转链接口前随机选取当前账号池中的一个账号发起请求流量被摊薄到多个配额上。需要注意不同账号的 PID 不同轮换模式下生成的短链归属不同推广位后台查佣金时要按账号分开看。轮换模式适合走量大的用户日常单账号够用就别开否则佣金报表碎片化月底对账会烦。6.2 关键词过滤与自动忽略规则监听转发模式下所有含京东链接的消息都会触发转链。往白名单里加关键词规则可以把「不想转的链接」过滤在门外。我常用的规则是排除包含「优惠券」「秒杀」等字样的链接这类消息通常附带时效性极短的满减活动转链后几小时就失效投入产出比太低。过滤规则是纯文本匹配大小写不敏感设置好后跑个半天看看日志里被忽略的链接情况再微调关键词列表。6.3 定时任务把批量转链固化到固定时段批量模式的另一个实用场景是做成定时任务。每天固定时段比如热门活动开始前半小时把当天收集的链接批量转好不用人工守着。我把这个流程写成了系统定时任务每天 9 点和 18 点各跑一次每次 30 条左右的链接输出到当天的日期命名的文件里。这样一来上午整理素材中午发一波晚上再发一波素材链路变得有节奏。定时任务的配置很简单定时器调用工具命令行即可。从做这件事开始我养成了一个习惯所有批量转链的输出文件都以日期命名绝不覆写旧文件方便月末统计到底转了多少条、哪些品类的链接转化最好。工具再自动化账目上的功夫省不得。希望这个习惯对你的投放效率也有帮助。本文还有配套的精品资源点击获取