指南 · JetBrains 插件

JetBrains 插件怎么被 AI 搜索找到?Marketplace 插件页实测

更新于 2026-11-12 · kagentx

短答案

2026-11-12 实测:JetBrains Marketplace 的 robots.txt 没有点名 AI 爬虫,sitemap_index.xml 里有一个 24,943 个网址的插件 sitemap;但插件详情页的 HTML 里去掉脚本后只剩标题,没有 meta description、canonical 和结构化数据,只有 og 标签,描述是脚本渲染的。所以官方要求的描述前 40 个字符(英文简短概述)最重要,它也是 og:description 里被读到的开头;其余介绍要写在官网和 README 里。AI 是否引用 Marketplace 页面,我们没有证据,未核实。

JetBrains Marketplace 对爬虫开放吗?

开放,没有点名 AI 爬虫。2026-11-12 我们用 curl 测了 plugins.jetbrains.com 的 robots.txt 和 sitemap(User-Agent 用 Mozilla/5.0):

检查项实测结果
robots.txt200,194 字节:* 组只禁 /plugin/download、/plugins/list、/pluginManager、*/ajax*;一行 Host;一行 Sitemap 指向 sitemap_index.xml
sitemap.xml404(返回 JSON:No static resource sitemap.xml),所以 sitemap 不在这个常见路径
sitemap_index.xml200,502 字节,4 个子 sitemap:插件、IntelliJ 平台文档、TeamCity 文档、Marketplace 文档
plugin/sitemap.xml200,2,795,011 字节,24,943 个网址,其中 24,939 个是 /plugin/<ID>-<名称>;23,139 个带 lastmod(最早的是 2005-06-18)

详情页网址是「ID + 名称」,名称部分来自插件名,所以插件名同时是网址的一部分。

插件详情页的 HTML 里有什么?

几乎只有标题和 og 标签。我们取了 Key Promoter X 的页面 plugins.jetbrains.com/plugin/9792-key-promoter-x(2026-11-12,curl,不执行脚本):

检查项实测结果
HTTP 状态和大小200,84,790 字节
title“Key Promoter X - IntelliJ IDEs Plugin | Marketplace”
meta description、canonical、JSON-LD都没有
og 标签有 og:title、og:type、og:url、og:image(插件图标)、og:description(插件描述的开头,在约 160 字符处用 ... 截断)
可见正文(去掉脚本后)78 个字符,只有 title;描述、版本、评分不在可见正文里,是脚本渲染的
换 User-Agent用 GPTBot、ClaudeBot、PerplexityBot 作为 User-Agent 字符串各取一次,都是 200、大小 84,771–84,789 字节,页面一样(这只是比较响应,不是真实爬虫的访问)

所以不执行脚本的爬虫,在这个页面上只拿到标题和 og:description 里的那一小段描述;爬虫是否执行脚本见 AI 爬虫会执行 JavaScript 吗?。真实搜索爬虫能读到什么,未核实。title 和描述的写法见 title 和 meta description 对 AI 搜索有用吗?。

Marketplace 另有一个不用登录就能取的 JSON 接口:plugins.jetbrains.com/api/plugins/9792(3,693 字节),字段有 name、description、preview、downloads、vendor、urls、tags、screens、icon 等;/api/plugins/9792/updates 是 43,644 字节。我们没有在官方文档里确认这是公开承诺的接口,只写「实测可以不登录取到」。

JetBrains 官方对插件名称和描述有什么规定?

JetBrains Marketplace 文档里的「Best practices for listing」(页面标注最后更新 2026-07-23,2026-11-12 读原文):

项目官方说法
名称建议 1–4 个词、最多 20 个字符;硬上限 60 个字符;不要用 “Plugin” 一词、emoji 或符号;不要在名称里写 JetBrains 或具体产品名
描述前 40 个字符必须是英文的简短概述;以英文为主、拼写正确、避免营销形容词;图片建议宽 600–800 像素;写描述时可以想着 SEO 关键词但不要堆砌,描述用在 Marketplace 的预览卡片上
截图建议最小 1200 × 760 像素;不要混用不同宽高比;主题类插件要展示视觉风格;视频建议短于 5 分钟
图标简单易认;尽量不带文字;不要只是重复插件名的文字;也可以不用图标
标签上传时至少选一个;会影响可搜索性;不要选插件不属于的分类
更新说明写在 plugin.xml 的 change-notes 标签里,最新的显示在插件页的 What’s new 和 IDE 的插件管理器里;太多时可以做成 Custom page
<idea-plugin>
  <id>com.example.csvtools</id>
  <name>Csv Tools</name>
  <description><![CDATA[
    Edit, validate and convert CSV files inside the IDE.
    <ul>
      <li>Highlights broken rows as you type</li>
      <li>Converts a selection to JSON</li>
    </ul>
  ]]></description>
  <change-notes><![CDATA[
    Fixes quoted fields that span two lines.
  ]]></change-notes>
</idea-plugin>

上面是 plugin.xml 的写法示例:描述第一行就是英文的一句话概述,正好落在官方要求的前 40 个字符里;这一段也是 og:description 里被读到的开头。官方没有写这些字段怎么影响 AI 引用,我们没有证据,未核实。

怎么一步一步让 JetBrains 插件更容易被找到?

  1. 1. 描述前 40 个字符写成一句话定义

    「做什么、在哪个 IDE 里」,用英文;这一段同时是官方要求的概述、预览卡片的开头,也是 og:description 能被爬虫读到的部分。

  2. 2. 名称短而具体

    1–4 个词;不要加 Plugin,不要写 JetBrains;名称会进详情页网址。

  3. 3. 选对标签

    至少一个,只选插件真正属于的。官方写明标签影响可搜索性。

  4. 4. 官网写一页完整介绍

    Marketplace 页对不执行脚本的爬虫只有标题和 og 标签。官网写清功能、支持的 IDE 版本、安装步骤、更新记录,并链到 Marketplace 页。写法见 GitHub README 会被 AI 搜索引用吗?。

  5. 5. 官网加 SoftwareApplication 数据

    描述同一个插件,运行环境写 IDE 名;写法见 SaaS 要不要加 SoftwareApplication 结构化数据?。

  6. 6. 隔几周用同一组问题再测

    问 ChatGPT、Perplexity「有没有做某某的 IntelliJ 插件」,每个问题问 3 次,记下有没有提到你、引用了哪些网址。

同类的商店对照:VS Code 扩展怎么被 AI 推荐?、Chrome 扩展怎么被 AI 推荐?、Raycast 扩展怎么被 AI 搜索找到?。

常见问题

JetBrains Marketplace 的插件页,爬虫不执行脚本能读到描述吗?

读不到。2026-11-12 用 curl 取 Key Promoter X 的插件页(84,790 字节),去掉脚本后只剩 78 个可见字符(只有 title);描述、版本、评分是脚本渲染的。HTML 里只有 og:description,内容是描述的开头。真实搜索爬虫是否执行脚本,未核实。

插件页的 meta description 是什么?

没有。页面没有 meta name=description,也没有 canonical 和 JSON-LD,只有 og:title、og:description 等 og 标签;og:description 是插件描述的开头,在约 160 字符处被截断。

JetBrains Marketplace 有 sitemap 吗?

有,但不在 /sitemap.xml(那里是 404)。robots.txt 里的 Sitemap 指向 sitemap_index.xml,里面有 4 个子 sitemap;插件的那个有 24,943 个网址,其中 23,139 个带 lastmod。

robots.txt 拦 AI 爬虫吗?

没有点名。2026-11-12 实测 robots.txt 是 194 字节:User-agent: * 下只禁 /plugin/download、/plugins/list、/pluginManager 和 */ajax*。

插件名称有什么要求?

官方建议 1–4 个词、最多 20 个字符(硬上限 60 个),不要用 “Plugin” 一词、emoji 或符号,也不要在名称里写 JetBrains 或具体产品名。

描述前面写什么最重要?

官方写明描述的前 40 个字符必须是英文的简短概述;描述要以英文为主,避免营销形容词;官方还写了写描述时可以想着 SEO 关键词,但不要堆砌,这段会用在 Marketplace 的预览卡片上。

标签有什么用?

官方写明上传时至少选一个标签,标签会影响可搜索性,不要选插件不属于的分类。

怎么让 AI 在 JetBrains Marketplace 之外也找到插件?

在官网写一页完整介绍(功能、支持的 IDE、安装步骤、更新记录),在 GitHub README 和官网互相链接。Marketplace 的页面对不执行脚本的爬虫只有标题和 og 标签,所以关键信息不要只放在 Marketplace。

出处

kagentx

你的页面,爬虫读得到吗?
让评测告诉你

评测检查爬虫能不能进、正文是否直出,再把买家的问题拿去问 ChatGPT、Perplexity、Claude(开联网搜索),看有没有提到你。基础版 $1,一般 2–3 分钟出结果。