[{"data":1,"prerenderedAt":249},["ShallowReactive",2],{"blog-api-versioning-docs-seo":3,"blog-prev-api-versioning-docs-seo":90,"blog-next-api-versioning-docs-seo":161},{"id":4,"title":5,"author":6,"body":7,"canonical":75,"category":76,"cover":75,"date":77,"description":78,"draft":79,"extension":80,"keywords":75,"meta":81,"navigation":82,"noindex":79,"ogImage":75,"path":83,"seo":84,"seoDescription":75,"seoTitle":75,"stem":85,"tags":86,"updated":75,"__hash__":89},"blog\u002Fblog\u002Fapi-versioning-docs-seo.md","API 版本化文档的 SEO 处理：旧版该留还是该删","元析智能",{"type":8,"value":9,"toc":67},"minimark",[10,14,18,21,24,27,30,42,45,49,52,55,58,61,64],[11,12,13],"p",{},"接口升版本时，旧文档别急着删。2025 年 5 月我们帮一个短信 API 做 v1 到 v2 的迁移，他们原计划把 v1 文档整体下架，我们拦住了。到 9 月，v1 文档每月还带来 1800 多次自然访问，占文档站总流量的 21%，那些用户还在用旧接口，或者正在从别家迁移过来。",[15,16,17],"h2",{"id":17},"旧文档的三个真实价值",[11,19,20],{},"第一，存量用户会搜。接口不会一夜之间换完，大客户的迁移周期经常是 12 到 18 个月。把文档删掉，他们会去搜缓存页或者第三方教程，你失去的是接触点。",[11,22,23],{},"第二，长尾词还在旧页面里。老接口的名字、参数名、报错信息，这些词搜索引擎已经认了旧 URL。页面一删，排名掉得很快，重新做回来要三到六个月。",[11,25,26],{},"第三，迁移指南需要一个落点。旧文档页顶部放一条“本版本已停止维护，迁移到 v2 看这里”，这是最自然的迁移入口，比发邮件有效。",[15,28,29],{"id":29},"怎么处理才不出重复内容",[11,31,32,33,37,38,41],{},"我们的做法分三步。第一步，旧版文档保留独立目录，路径里带版本号，比如 ",[34,35,36],"code",{},"\u002Fdocs\u002Fv1\u002F","，新版是 ",[34,39,40],{},"\u002Fdocs\u002Fv2\u002F","。第二步，旧版每页顶部加一条醒目提示，写清停止支持的时间和迁移链接。第三步，canonical 指向自己，不要指向新版——这两页内容不同，指向新版会让搜索引擎把旧页丢掉。",[11,43,44],{},"真正要合并的是“同名不同版”的重复页。比如参数说明页在两版里几乎一样，就把旧版那页设成 noindex，只保留入口页和差异页。这个边界我们一般按改动幅度定：参数变了超过三成，独立页；不到三成，合并加版本标注。",[15,46,48],{"id":47},"版本号要不要进-title","版本号要不要进 title",[11,50,51],{},"要。用户搜“短信 API v2 发送”和“短信 API 发送”，是两个意图。title 里带版本号，点击率会高，也避免了用户点进去发现版本不对。",[11,53,54],{},"还有一个小技巧：在旧版页面底部列出“本版和 v2 的差异”，用表格，五行以内。这张表经常被第三方博客转引，带外链回来。",[15,56,57],{"id":57},"什么时候可以删",[11,59,60],{},"两种情况可以删。一是旧版停止支持超过 24 个月，且月访问低于 100，先做 301 到新版对应页，观察一个季度。二是旧版从来没被索引过，那删了也没损失。",[11,62,63],{},"最后一句：版本迁移期至少留 6 个月的并行文档，别在发版当天就切。用户迁移是跟着自己的迭代节奏走的，不是你发公告的节奏。",[11,65,66],{},"判断这件事别拍脑袋，看 Search Console 里那些 URL 的展示和点击，数据会告诉你答案。我们现在的默认动作是：先留，加提示，设 canonical，半年后再看数据决定。删文档是不可逆的，留文档的成本只是几十个页面的维护。",{"title":68,"searchDepth":69,"depth":69,"links":70},"",2,[71,72,73,74],{"id":17,"depth":69,"text":17},{"id":29,"depth":69,"text":29},{"id":47,"depth":69,"text":48},{"id":57,"depth":69,"text":57},null,"技术SEO","2025-10-20","接口升到 v2 之后，v1 文档删了排名会掉，留着又怕重复内容。我们给三个 API 产品做版本迁移，最后都选了同一套处理方式：留页面、加迁移提示、只合并差异小的页。",false,"md",{},true,"\u002Fblog\u002Fapi-versioning-docs-seo",{"title":5,"description":78},"blog\u002Fapi-versioning-docs-seo",[87,88,76],"API 文档","版本管理","ZLoQyqCHHC3T3WB2YjJVI4-TIU2dCBej49HSIKYK5ME",{"id":91,"title":92,"author":6,"body":93,"canonical":75,"category":149,"cover":75,"date":150,"description":151,"draft":79,"extension":80,"keywords":75,"meta":152,"navigation":82,"noindex":79,"ogImage":75,"path":153,"seo":154,"seoDescription":75,"seoTitle":75,"stem":155,"tags":156,"updated":75,"__hash__":160},"blog\u002Fblog\u002Freciprocal-link-red-lines.md","互链换量可以做，站群那套东西碰都别碰",{"type":8,"value":94,"toc":144},[95,98,101,108,114,120,123,126,129,132,135,138,141],[11,96,97],{},"先说结论：互链本身没问题，它是正常商业合作的一部分。但一旦变成\"一群站互相对着链、链成一个网\"，性质就变了。今年 6 月我们拒过一个合作，对方手里 200 个站，要求 A 链 B、B 链 C、C 链 A，还附了一张名单让我们挑。我们看完名单只问了一句：这 200 个站里，有多少是你们自己注册的？对方没回答，合作就到此为止。",[15,99,100],{"id":100},"三条红线",[11,102,103,107],{},[104,105,106],"strong",{},"三角链和闭合链。"," 搜索引擎识别站点关联的能力比大多数老板想的强，注册信息、服务器 IP、页面模板、友链名单重叠，都能成为线索。闭合互链是最容易被识别的一类，别做。",[11,109,110,113],{},[104,111,112],{},"批量互换。"," 一次换十几条、几十条，基本可以判定为联盟操作。正常的商业互链，一年也就几条到十几条，而且是零散发生的。我们给自己的客户定过一条内部规则：单月新增互链不超过 2 条，一年累计不超过 10 条。超过这个量，动作本身就开始像操作了。",[11,115,116,119],{},[104,117,118],{},"跨主题硬换。"," 做工业软件的站和做母婴用品的站互换，除了让两边的主题信号变乱，没有任何收益。这类交换往往是对方主动找上门，说\"我们权重高，互换个首页\"，一律拒。",[15,121,122],{"id":122},"为什么三角链最危险",[11,124,125],{},"单条互链是两家的事，风险可控。三角链一旦形成网，任何一家出问题都会牵连整张网。2024 年我们接过一个善后：客户被一家合作站牵连，核心词掉了 9 位，恢复用了 4 个月。中间我们还发现，客户自己都没意识到那 6 条链接连成一圈，是对方给的一张\"合作站点\"表格造成的。客户当时觉得\"只是换个链接，能有多大事\"，恢复期的损失远超当初省下的推广费。",[11,127,128],{},"所以我们现在对这类合作的态度是：不接，不管对方报价多低。有些钱不赚，是因为后面要花更多钱去修。",[15,130,131],{"id":131},"换链的正确姿势",[11,133,134],{},"一年 5 到 8 条，主题相关，位置在首页或频道页都行，加 nofollow 也能接受。原因很简单：互链的真实价值是引流和品牌曝光，不是纯粹传权重。指望互链拉排名，本身就是把命交给别人。",[11,136,137],{},"还有一个判断标准很好用：对方要求你的首页挂 20 条以上友链，说明他的首页就是个链接集散地，这种链换了等于给自己找麻烦。",[11,139,140],{},"存量互链也要盘。我们把客户站点的友链导出，一条条查历史快照和主题，三个月盘一次，掉队的一次性撤掉。盘完通常能砍掉三到五成，排名没有变化，反而少了一个隐患。这件事不难，难的是坚持做，因为没人会因为\"没出事\"给你发奖金。",[11,142,143],{},"我宁愿客户一年只换 4 条友链，也不愿意看到一张\"互链联盟\"名单。少而真，比多而乱值钱。",{"title":68,"searchDepth":69,"depth":69,"links":145},[146,147,148],{"id":100,"depth":69,"text":100},{"id":122,"depth":69,"text":122},{"id":131,"depth":69,"text":131},"SEO","2025-10-19","今年 6 月我们拒了一个互链联盟的合作，对方手里 200 个站，要求三家互链。这篇讲互链的三条红线、为什么三角链最危险，以及软件公司换链的正确姿势。",{},"\u002Fblog\u002Freciprocal-link-red-lines",{"title":92,"description":151},"blog\u002Freciprocal-link-red-lines",[157,158,159],"互链","链接风险","站群","4Vkz4fFVJDpOBUXxe9HXx52liVKuRiou7ErqTfH6-Hs",{"id":162,"title":163,"author":6,"body":164,"canonical":75,"category":237,"cover":75,"date":238,"description":239,"draft":79,"extension":80,"keywords":75,"meta":240,"navigation":82,"noindex":79,"ogImage":75,"path":241,"seo":242,"seoDescription":75,"seoTitle":75,"stem":243,"tags":244,"updated":75,"__hash__":248},"blog\u002Fblog\u002Fsogou-webmaster-platform-value.md","搜狗站长平台还在更新，但这三类站不值得投入",{"type":8,"value":165,"toc":229},[166,169,172,175,178,181,184,187,190,193,196,199,202,205,208,211,214,217,220,223,226],[11,167,168],{},"搜狗值得做，但不值得专门做。它现在的流量集中在 PC 端和输入法、浏览器默认入口，移动端被微信和头条分走大半。我们拿 5 个站试了半年，结论很清楚。",[15,170,171],{"id":171},"先看我们手上的数据",[11,173,174],{},"5 个站，搜狗带来的流量占比分别是 2.1%、2.8%、3.4%、4.7%、5.8%。最高的是一个开发者工具站，最低的是一个客单价几十万的企业软件官网。",[11,176,177],{},"去年 11 月到今年 4 月，我们在搜狗上投入约 30 小时：提交 sitemap、每周手动提交 20 条 URL、盯着收录和排名。同样 30 小时投在百度上，产出至少是搜狗的 6 倍。",[15,179,180],{"id":180},"三类站别做",[11,182,183],{},"第一类，面向开发者的英文站。搜狗以中文搜索需求为主，英文页面收录和展现都很少。我们那个英文文档站，300 篇里搜狗收了不到 20 篇，零流量。",[11,185,186],{},"第二类，客单价 50 万以上的企业软件。搜狗用户的行为偏\"快速找答案、快速下载\"，决策链短。这类客户在搜狗上拿不到像样的询盘，我们试了 4 个月，有效咨询 1 个。",[11,188,189],{},"第三类，新站。搜狗对新站的收录节奏慢，我们一个上线 3 个月的新站，搜狗收录用了 40 多天才过百页，同期百度 12 天。早期把精力放这儿不划算。",[15,191,192],{"id":192},"两类站可以顺手做",[11,194,195],{},"一类是有 PC 下载需求的工具。搜狗输入法、搜狗浏览器的默认搜索入口还在，工具类下载页在这上面有点量。我们一个截图工具客户，搜狗每月带来 800 多次下载页访问。",[11,197,198],{},"另一类是已经在百度有稳定排名的站。我们观察到搜狗的结果和百度重合度不低，百度排得好的页面，搜狗通常也不会太差。这类站把 sitemap 提交一下、每周推 20 条新 URL，边际成本几乎为零。",[15,200,201],{"id":201},"搜狗站长平台具体怎么操作",[11,203,204],{},"注册后走站点验证，支持 meta 标签和文件验证。验证完提交 sitemap，再在收录提交入口手动推 URL，每天有配额，我们一般推 20 条。",[11,206,207],{},"搜狗的抓取诊断做得比较粗，只能看状态和抓取时间，看不到抓取到的 HTML。所以搜狗上的问题，我们基本靠日志反推。",[11,209,210],{},"收录周期按 10 到 20 天预期，别按百度的 3 到 5 天算。排名监测每季度看一次就够，不值得每周盯。",[15,212,213],{"id":213},"搜狗流量被谁分走了",[11,215,216],{},"我们自己几个站的日志里，搜狗带来的访问从 2023 年到现在大概掉了四成。掉的部分主要去了两个地方：微信搜一搜（很多用户直接在微信里搜）和头条、抖音的搜索框。",[11,218,219],{},"这不代表搜狗不能做，而是它不再是“国内第二引擎”的位置。把它当补充渠道，预期放低，心态会好很多。",[15,221,222],{"id":222},"我们的做法",[11,224,225],{},"搜狗的定位是\"顺手\"，不是\"战略\"。客户预算里我们从不单列搜狗，只在做百度的时候把 sitemap 和提交带上。",[11,227,228],{},"把预算压在这上面是浪费。真要做第二个国内引擎，优先看 360，它的 PC 端量比搜狗稳定。",{"title":68,"searchDepth":69,"depth":69,"links":230},[231,232,233,234,235,236],{"id":171,"depth":69,"text":171},{"id":180,"depth":69,"text":180},{"id":192,"depth":69,"text":192},{"id":201,"depth":69,"text":201},{"id":213,"depth":69,"text":213},{"id":222,"depth":69,"text":222},"行业观察","2025-10-21","搜狗被腾讯收购后搜索流量还在，但结构变了。我们拿 5 个站试了半年：三类站别在搜狗上花时间，两类可以顺手做，也写了搜狗站长平台的具体操作和真实的收录周期，省得你重复踩坑。数据来自我们自己 5 个在管站点，不是行业报告。",{},"\u002Fblog\u002Fsogou-webmaster-platform-value",{"title":163,"description":239},"blog\u002Fsogou-webmaster-platform-value",[245,246,247],"搜狗","多引擎","流量结构","CusO9s4zxpA41qtcp-5fI0BY5YYjsHhve2SG_oWMavA",1794088111490]