[{"data":1,"prerenderedAt":266},["ShallowReactive",2],{"blog-api-reference-seo-structure":3,"blog-prev-api-reference-seo-structure":91,"blog-next-api-reference-seo-structure":178},{"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__":90},"blog\u002Fblog\u002Fapi-reference-seo-structure.md","API 参考页别按模块拆，按用户任务拆","元析智能",{"type":8,"value":9,"toc":67},"minimark",[10,14,18,21,24,27,43,46,49,52,55,58,61,64],[11,12,13],"p",{},"API 文档的信息架构，决定了你的文档能吃到多少搜索流量。2025 年 3 月我们重做一个支付 API 的文档站，原本 210 个端点塞在 12 个按模块分的页面里，全部内容只有 12 个 URL。改成“一个端点一个页面”后，六个月自然流量涨了 1.4 倍，被 AI 回答引擎引用的次数从每月个位数到四十多次。",[15,16,17],"h2",{"id":17},"按模块拆为什么不好",[11,19,20],{},"模块是开发者的分类，不是搜索者的语言。用户搜的是“创建退款”“查询结算批次”“取消订阅”，不是“结算模块 API 参考”。按模块拆的页面，一个 URL 里混着八到十个端点，title 只能写成模块名，页面里每段都浅，排名上不去。",[11,22,23],{},"更要命的是锚点没法被当作独立结果。用户搜“stripe 创建退款接口”，搜索结果的标题是“退款 API”，描述里是整段模块说明，点击率低。拆开之后标题能写“创建退款 - 退款接口 v2”，点击率差别很大。",[15,25,26],{"id":26},"拆页的三条规则",[11,28,29,30,34,35,38,39,42],{},"第一，按“用户要做的事”命名。URL 用动词加对象：",[31,32,33],"code",{},"\u002Fapi\u002Fcreate-refund","、",[31,36,37],{},"\u002Fapi\u002Flist-settlements","，不要用 ",[31,40,41],{},"\u002Fapi\u002Frefund-endpoint-v2","。标题用中文任务名加版本，别用英文函数名做主标题。",[11,44,45],{},"第二，一个端点一页，但相同语义的批量接口合并。比如查询单个和查询列表，合成一页两个示例。我们拆 210 个端点最后出了 148 个页面，合并的都是这类。",[11,47,48],{},"第三，页面结构统一成五段：干什么用、请求参数表、返回示例、错误码、常见问题。参数表用真实默认值，别写“见下文”。",[15,50,51],{"id":51},"拆分之后要接内链",[11,53,54],{},"拆完最容易犯的错是页面之间互不相通。我们的做法是每个页面底部固定放两块：本页相关的上游接口、下游接口各两到三个。比如“创建退款”下面放“查询退款状态”“列退款列表”。这部分我们写了个脚本从 OpenAPI 文件自动生成，省了人工。",[11,56,57],{},"还有一个位置别漏：每个端点的“错误码”要链到错误码总表，总表再链回具体端点。这一进一出，把文档站织成网。",[15,59,60],{"id":60},"哪些页不该单独拆",[11,62,63],{},"不是所有端点都值得一个页面。内部调试用的、已废弃的、只在企业版开放的，都不拆，放在一页里说明就行。拆完留下 20 个只有一句话的页面，会稀释整站质量。判断标准很简单：这个端点有没有人会用一句话去搜它。",[11,65,66],{},"拆分是工程活，不是内容活。改完之后要盯三个数：索引覆盖、页面平均展示、文档到注册的转化。前两个涨得慢，第三个通常一个月内就能看到变化。",{"title":68,"searchDepth":69,"depth":69,"links":70},"",2,[71,72,73,74],{"id":17,"depth":69,"text":17},{"id":26,"depth":69,"text":26},{"id":51,"depth":69,"text":51},{"id":60,"depth":69,"text":60},null,"技术SEO","2025-10-12","一个支付 API 文档有 210 个端点，原来按模块分了 12 页，改成一个端点一页后自然流量涨了 1.4 倍。具体怎么拆、URL 怎么起、哪些页不该单独做。",false,"md",{},true,"\u002Fblog\u002Fapi-reference-seo-structure",{"title":5,"description":78},"blog\u002Fapi-reference-seo-structure",[87,88,89],"API 文档","信息架构","开发者工具","8XzHqLzBAT3EQnxJKi7fS13Ynxu163zr4qVzxtv0L2M",{"id":92,"title":93,"author":6,"body":94,"canonical":75,"category":166,"cover":75,"date":167,"description":168,"draft":79,"extension":80,"keywords":75,"meta":169,"navigation":82,"noindex":79,"ogImage":75,"path":170,"seo":171,"seoDescription":75,"seoTitle":75,"stem":172,"tags":173,"updated":75,"__hash__":177},"blog\u002Fblog\u002Ffriend-link-due-diligence-checklist.md","友情链接尽调：六个字段决定这条链要不要换",{"type":8,"value":95,"toc":161},[96,99,102,105,112,118,124,130,136,142,146,149,152,155,158],[11,97,98],{},"友情链接是软件公司最容易踩坑的一类外链，因为它是人对人换的，中间没有平台把关。今年 3 月到 8 月，我们帮 3 个软件站审过 63 条存量友链，退掉 41 条，其中有 6 条已经在拖排名。",[11,100,101],{},"结论先说：换友链前必须逐项核对六个字段，任何一项不过红线，这条链就不值得换。",[15,103,104],{"id":104},"六个字段和它们各自的红线",[11,106,107,111],{},[108,109,110],"strong",{},"出站链接数。"," 打开对方首页数一遍外部链接，超过 30 条的别换。首页挂几十条友链的站，本质是链接集散地，分到你身上的权重很少，还容易被一起处理。",[11,113,114,117],{},[108,115,116],{},"收录与快照。"," 用 site 查对方首页是否收录，看快照时间。快照停在三个月前、首页搜不到的，说明蜘蛛已经很少去了。",[11,119,120,123],{},[108,121,122],{},"历史快照。"," 用网页存档工具看这个域名两年前是什么内容。我们查出一条\"软件导航站\"，两年前是博彩站，域名换过主体但没换干净，这类坚决不换。",[11,125,126,129],{},[108,127,128],{},"主题相关度。"," 至少同属软件、技术、B2B 服务。卖机械配件的站和做 SaaS 的互换，主题信号是乱的，收益接近零。",[11,131,132,135],{},[108,133,134],{},"更新频率。"," 近半年首页或栏目有没有更新。一个两年没更新的站，链接还在，承载的价值已经没了。",[11,137,138,141],{},[108,139,140],{},"交换方式。"," 是否要求首页互换、是否要求三家互链。三角互链是最危险的形态，后面单独说。",[15,143,145],{"id":144},"一个真实案例换-6-条掉-3-名","一个真实案例：换 6 条，掉 3 名",[11,147,148],{},"2024 年 12 月，一个客户在两周内换了 6 条友链，其中 2 条属于三角链。2025 年 1 月核心词从第 4 掉到第 7，另一组词掉了 5 位。我们复盘发现这 6 条里有 3 条来自同一批注册的域名，撤掉后第 6 周排名恢复，前后折腾了两个月。",[11,150,151],{},"这件事之后，我们给自己定了规矩：友链一次最多换 2 条，间隔不少于两周，全部走台账。",[15,153,154],{"id":154},"我们现在的操作流程",[11,156,157],{},"先查后换，建一张表记录对方域名、上线日期、页面 URL、复查日期。每季度复查一次，看到掉链、页面改版、主题变化，立刻撤。撤链要在两周内完成，别拖。",[11,159,160],{},"友链换的是信任，不是数量。宁可少 20 条，也不接一条来路不明的。",{"title":68,"searchDepth":69,"depth":69,"links":162},[163,164,165],{"id":104,"depth":69,"text":104},{"id":144,"depth":69,"text":145},{"id":154,"depth":69,"text":154},"SEO","2025-10-11","今年我们帮 3 个软件站审过 63 条存量友链，退掉了 41 条。这篇给一张六字段核对表：出站链接数、收录、历史快照、主题相关、更新频率、交换方式，每项都附红线值。",{},"\u002Fblog\u002Ffriend-link-due-diligence-checklist",{"title":93,"description":168},"blog\u002Ffriend-link-due-diligence-checklist",[174,175,176],"友情链接","外链尽调","链接风险","mFe8a8L-4e7CpWntLtLCMuWoUUBkPo7PFjgfTygCvMU",{"id":179,"title":180,"author":6,"body":181,"canonical":75,"category":254,"cover":75,"date":255,"description":256,"draft":79,"extension":80,"keywords":75,"meta":257,"navigation":82,"noindex":79,"ogImage":75,"path":258,"seo":259,"seoDescription":75,"seoTitle":75,"stem":260,"tags":261,"updated":75,"__hash__":265},"blog\u002Fblog\u002Fbing-webmaster-tools-setup.md","Bing 站长工具的三个设置，每个新站我们都会做",{"type":8,"value":182,"toc":247},[183,186,190,193,196,199,203,206,209,212,216,219,222,225,229,232,235,238,241,244],[11,184,185],{},"Bing 在国内搜索份额不大，但它的索引不只服务 Bing 搜索，还喂给 Copilot 这类产品。我们每个新站上线第一周固定做三个设置，20 分钟能做完，性价比很高。",[15,187,189],{"id":188},"设置一验证站点提交-sitemap","设置一：验证站点，提交 sitemap",[11,191,192],{},"Bing 站长工具支持三种验证：XML 文件、meta 标签、CNAME。我们用 XML 文件放根目录，最稳，换程序、换主题都不影响。",[11,194,195],{},"验证完提交 sitemap。Bing 的 sitemap 处理比 Google 慢，一般 48 小时内能在后台看到\"已发现 URL\"数。我们一个 800 页的站，提交后第二天显示发现 780 条，第三天开始有收录。",[11,197,198],{},"有个坑：国内网络访问 Bing 站长工具偶尔会验证失败，我们一般直接切国际版后台，用同一个微软账号就行。",[15,200,202],{"id":201},"设置二开-indexnow","设置二：开 IndexNow",[11,204,205],{},"IndexNow 是 Bing 牵头的即时收录协议，Yandex、Naver 也支持，Google 不支持。发布新页面时向接口推一条 URL，Bing 会优先抓。",[11,207,208],{},"我们测过 30 次：IndexNow 推送后平均 4 小时被抓，等 sitemap 平均 26 小时。对新闻、更新日志、版本发布这类时效内容差别明显，对普通产品页差别不大。",[11,210,211],{},"接入成本很低，一个 POST 请求，带 key 和 URL 列表。WordPress、Hugo 都有现成插件，自建站写 20 行脚本。我们所有新站默认接。今年 9 月给 3 个新站的发布流程加了这一步，版本日志页平均 3 小时就进了 Bing 索引。",[15,213,215],{"id":214},"设置三看搜索性能挖长尾词","设置三：看搜索性能，挖长尾词",[11,217,218],{},"Bing 的搜索性能报告和关键词研究工具，给的是 Bing 自己的数据。和 Google 差得很多，不能直接套用。",[11,220,221],{},"我们做过对比：一个 API 监控类关键词，Google 月搜索量约 2400，Bing 只有 180 左右。但竞争度低得多，一个客户在 Bing 上做到第 3，一个月带来 40 多个试用注册，成本是 Google 的零头。",[11,223,224],{},"方法：在 Bing 关键词工具里筛\"搜索量 50 到 300、竞争度低\"的词，优先做能直接对应产品功能的。这类词 Google 上做不动，Bing 上还有空间。",[15,226,228],{"id":227},"bing-对中国站的收录节奏","Bing 对中国站的收录节奏",[11,230,231],{},"Bing 对中文站的收录比英文站慢，我们几个新站的中文页面，首批收录用了 7 到 12 天。它更认备案信息完整的站，这点和百度有点像。",[11,233,234],{},"另一个观察：Bing 对页面标题的抓取偏保守，标题堆关键词的页面，Bing 会截断后半段展示。标题写成一句完整的话，Bing 的展示反而更完整。",[15,236,237],{"id":237},"我们的判断",[11,239,240],{},"Bing 不是主战场，但配置成本低到可以忽略，AI 搜索产品的引用来源里 Bing 系占的比重不低。新站上线顺手把这些做完，后面不用再补。",[11,242,243],{},"上个月我们回看这批站，Bing 带来的注册占比 4% 到 7%，绝对值不大，但单个注册成本大约是 Google 的五分之一。",[11,245,246],{},"如果只能做一件事，先做 IndexNow。它的投入产出比在这三个设置里最高。",{"title":68,"searchDepth":69,"depth":69,"links":248},[249,250,251,252,253],{"id":188,"depth":69,"text":189},{"id":201,"depth":69,"text":202},{"id":214,"depth":69,"text":215},{"id":227,"depth":69,"text":228},{"id":237,"depth":69,"text":237},"工具评测","2025-10-13","Bing 在国内份额不大，但它的索引还喂给 Copilot 这类产品。我们每个新站上线第一周固定做三个设置：验证并提交 sitemap、接 IndexNow、看搜索性能挖长尾词，20 分钟能做完。今年给 7 个新站配过，收录周期平均快一周。配置不难，难在有人告诉你先做哪一步。",{},"\u002Fblog\u002Fbing-webmaster-tools-setup",{"title":180,"description":256},"blog\u002Fbing-webmaster-tools-setup",[262,263,264],"Bing","站长工具","收录","MGvMbHDU0oJfSwYq_Lav_osNw-Mb6M9OCBqsfO2oaAU",1794088111698]