WordPress.org 的插件页,AI 读得到吗?
读得到的内容很多。2026-11-10 我们读了 wordpress.org 的 robots.txt 和一个插件页(Contact Form 7):插件页没被 robots.txt 禁止,描述全文、评分、安装量和更新日期都直接写在 HTML 里,页面还带一段 SoftwareApplication 的 JSON-LD。AI 是否读取并引用这些页面,官方没有说明,我们没有拿到实际引用的证据,未核实。
| 我们查到的 | 结果(2026-11-10) | 能说明什么 |
|---|---|---|
| robots.txt | 点名 GPTBot、ClaudeBot、anthropic-ai、Google-Extended、Applebot-Extended、PerplexityBot、Bytespider、CCBot、Copilot,每组都是 Allow: /;只禁 /wp-admin/、/search、/?s= 和 /plugins/search/;列出 9 个 sitemap | 插件页对这些爬虫明确放行;OAI-SearchBot、ChatGPT-User、Claude-User、Perplexity-User 没被点名,走 * 的规则,也没被禁 |
| 插件页的 HTML(约 196 KB) | title 是“插件名 – WordPress plugin | WordPress.org”;meta description 和 og:description 都等于 readme 的 short description;canonical 指向自己 | short description 同时是搜索结果和 AI 最先读到的一句话 |
| 结构化数据 | 一段 JSON-LD,类型是 SoftwareApplication 加 Product:applicationCategory(Plugin)、operatingSystem(WordPress)、softwareVersion、downloadUrl、dateModified、aggregateRating、下载次数、图片 | 版本、更新日期、评分和评价数以结构化数据的形式出现;这是目录生成的,你只能通过 readme 和插件头信息影响它 |
| 页面可见文字 | Description 全文、Installation、FAQ、Reviews、Changelog 的标题,右栏有安装量、最后更新、需要的 WordPress 和 PHP 版本、测试到的版本、语言、各星级评价数 | 不用执行脚本就能读到;readme 里的每个字段都对应页面上的一块文字 |
| 插件 sitemap | /plugins/sitemap.xml 是 sitemap 索引,指向 sitemap-index-1.xml(37 条)和图片 sitemap;一份子 sitemap 有 1,000 个网址,含插件页 | 新插件和更新都有机会被爬虫发现 |
| 公开 JSON 接口 | api.wordpress.org/plugins/info/1.2/ 返回 JSON:版本、要求、评分、安装量、sections(description、installation、faq、changelog 等)、tags | 程序化读取插件信息有现成的接口;AI 产品是否用它,未核实 |
和 WordPress 网站本身(你自己的官网)不同:官网的爬虫规则、结构化数据和正文直出见 WordPress 网站怎么做 AI 搜索优化?。这一篇只讲插件目录页,以及插件作者还要在自己的网站上补什么。
readme.txt 的每个字段,官方的上限是多少,怎么写?
插件页上的文字几乎都来自 readme.txt 和插件主文件的头信息。下面的上限来自 Plugin Handbook(2026-11-10 查看);“怎么写”是我们的建议。
| 字段 | 官方说明 | 怎么写 |
|---|---|---|
| short description(头信息后的第一段) | 不超过 150 字符,不带标记;超过会被截断;显示在插件名正下方 | 一句话:给谁、做什么,不写“最好”,不堆关键词;它就是 meta description |
| Tags | 1 到 5 个;不得用竞争对手的插件名做标签;只有自己才用的标签不会显示 | 选用户真会搜的词,如 reviews、product reviews,不用长句 |
| Requires at least、Requires PHP | 自 WordPress 5.8 起从插件主 PHP 文件读取,readme 里的这两项不再被解析 | 在主文件头信息里写准,页面右栏的版本要求来自这里 |
| Tested up to | 写 WordPress 的大版本,小版本会被忽略 | 每个 WordPress 大版本发布后测一遍就更新,右栏的“测试到”是 AI 判断插件是否还在维护的线索之一(推断,未核实) |
| Description 区块 | 官方没有给字数上限,只提醒 readme 超过 10k 可能出错,描述应是对插件的说明,不是销售文案 | 第一段直接定义插件;用二级标题写功能、适合谁、和同类的区别 |
| FAQ 区块 | 官方说 FAQ 应该真正回答问题 | 一问一答,问题用用户的原话,如“和 WooCommerce 兼容吗?” |
| Changelog 区块 | 官方建议 readme 只留当前版本,更早的放 changelog.txt | 每条写版本号和真实日期 |
| 图片(assets 目录) | banner-772x250(高清 1544x500);icon-128x128、256x256 或 icon.svg;screenshot-1.png 起,文件名小写,每张在 readme 里要有对应一行 | 截图的说明文字要写成完整的一句,不要只靠图片 |
一个官方没写、但我们实测看到的事实:readme 的 Description、Installation、FAQ 和 Changelog 都在插件页的 HTML 里(以及 API 的 sections 里),所以 readme 就是你在目录页上能控制的全部正文。更新日志页怎么写,见 更新日志页(changelog)对 AI 搜索有用吗?;对比页见 「X vs Y」对比页怎么写才会被 AI 引用?。
插件有了目录页,为什么还要自己的官网?
因为目录页只放得下 readme:格式固定,没有“和某某插件比有什么区别”“适合哪类站点”这类被 AI 当成回答素材的内容,也放不下你的价格、支持政策和案例。这些要写在你自己的网页上,并和 readme 保持一致。
| 页面 | 要回答的问题 | 写什么 |
|---|---|---|
| 插件落地页 | 这个插件是什么,给谁用? | 第一段与 readme 的 short description 同义;功能表;要求的 WordPress 和 PHP 版本;链到目录页;更新日期 |
| 对比页 | 它和某某插件比有什么区别? | 一张对比表,每项写出处和日期 |
| 更新日志页 | 最新版本改了什么? | 版本号、日期、改动分类,和 readme 的 Changelog 一致 |
| 收费说明页(有付费版的话) | 哪些功能在哪个版本里? | 按版本列功能和价格,写更新日期 |
结构化数据:目录页已经带了 SoftwareApplication,你自己的落地页也加一份,字段和正文一致,写法见 SaaS 要不要加 SoftwareApplication 结构化数据?。如果插件同时是 GitHub 上的开源项目,README 和仓库的写法见 开源项目怎么被 AI 搜索推荐?README 以外的 6 个地方。
怎么一步一步让插件更容易被 AI 推荐?
1. 先把 readme 的开头写对
short description 控制在 150 字符以内,写成一句完整的话,示例见下。第一段 Description 直接定义插件。
=== Example Reviews Plugin === Contributors: yourwordpressorgusername Tags: reviews, product reviews, testimonials Requires at least: 6.0 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.4.0 License: GPLv2 or later Collect and display product reviews on WooCommerce stores, with email requests and a reviews block. == Description == Example Reviews Plugin sends a review request after an order ships and shows the reviews on product pages. == Changelog == = 1.4.0 - 2026-11-03 = * Added: reviews block for the block editor.
2. 保证每个版本都更新 Tested up to 和 Changelog
每个版本一条,带真实日期;更早的记录挪到 changelog.txt,readme 保持在 10k 以内。
3. 把 FAQ 写成用户的原话
从支持论坛里最常见的问题挑,一问一答。
4. 给自己的官网做插件落地页
第一段与 short description 同义,加功能表、版本要求、对比页链接、更新日志。官网的爬虫规则用 AI 爬虫检查 检查,规则见 AI 爬虫的 robots.txt 怎么写。
5. 在官网加 SoftwareApplication 结构化数据
名称、版本、applicationCategory 和 operatingSystem 与目录页一致,写法见 SaaS 要不要加 SoftwareApplication 结构化数据?。
6. 两个月后用同一组问题再测
用“某类问题 + WordPress 插件”问 ChatGPT、Perplexity,记下有没有提到你;没有就回到第 3 步补 FAQ 和对比页。
官网不是 WordPress 的话,同样适用;官网是 WordPress 的话,插件、主题和 SEO 插件自己带来的坑见 WordPress 网站怎么做 AI 搜索优化?。
做的是 Google Workspace 插件的话,Marketplace 应用页的 robots.txt、sitemap 实测和官方上架要求见 Google Workspace 插件怎么被 AI 搜索找到?Marketplace 应用页实测。
做的是 Jira 或 Confluence 应用的话,Atlassian Marketplace 应用页的 robots.txt、sitemap 实测和官方命名规则见 Atlassian Marketplace 应用怎么被 AI 搜索找到?应用页实测与官方要求。
常见问题
WordPress 插件目录的页面会被 ChatGPT 引用吗?
我们没有找到官方说明,也没有拿到实际引用的证据,未核实。能确认的是:2026-11-10 实测 wordpress.org 的 robots.txt 对 GPTBot、ClaudeBot、PerplexityBot 等写了 Allow: /,插件页没有被禁止,描述和评分在 HTML 里。
readme.txt 的 short description 最多多少字符?
官方的 readme.txt 说明(2026-11-10 查看)写明不超过 150 字符、不带标记,超过会被截断。它也是插件页的 meta description。
标签最多几个?
官方说明是 1 到 5 个,不得使用竞争对手的插件名,只有自己才用的标签不会显示。
插件页上的评分会影响 AI 推荐吗?
未核实。官方没有说明。能确认的是评分和评价数写在插件页的 HTML 和 JSON-LD 里。
Requires PHP 写在 readme 里还是主文件里?
官方说明(2026-11-10 查看):自 WordPress 5.8 起,readme 里的 Requires PHP 和 Requires at least 不再被解析,从插件主 PHP 文件的头信息读取。
出处
- WordPress.org · wordpress.org/robots.txt (2026-11-10 读取)
- WordPress.org · Example plugin page (checked for what the HTML contains) (2026-11-10 读取)
- WordPress.org · wordpress.org/plugins/sitemap.xml (2026-11-10 读取)
- WordPress Developer Resources · How Your readme.txt Works (查看于 2026-11-10)
- WordPress Developer Resources · Plugin Assets (查看于 2026-11-10)
- kagentx 评测:案例页的数据,日期写在每个例子里。