mcpField
G
geo-llmstxt

geo-llmstxt

github.com/zubair-trabzada营销与增长11.3k1.3k 次安装3 周前更新
代码仓库

关于 geo-llmstxt

geo-llmstxt 是用于分析现有 llms.txt 文件并根据网站内容生成新文件的 skill,指导用户检查格式、评估内容、筛选页面并组装文件。

主要功能

  1. 01分析现有 llms.txt 文件
  2. 02检查结构和 URL
  3. 03评估完整性与准确性
  4. 04发现并筛选网站页面
  5. 05生成 llms.txt 和报告

适用场景

  1. 01审查网站现有的 llms.txt
  2. 02根据网站页面创建 llms.txt

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/zubair-trabzada/geo-seo-claude --skill geo-llmstxt

安装后在 Claude Code 中输入/geo-llmstxt确认已加载。

详细介绍

llms.txt 标准分析与生成技能

用途

此技能涵盖与 llms.txt 标准相关的所有内容——这是一项新兴约定(由 Jeremy Howard 于 2024 年 9 月提出,并在 2025-2026 年逐渐普及),旨在让网站能够向 AI 系统提供有关其内容、结构和关键信息的结构化指南。它类似于 robots.txt(告知爬虫哪些内容不可访问),但 llms.txt 告知 AI 系统哪些内容最值得了解。

llms.txt 为何重要

AI 语言模型在处理网站时面临一项根本挑战:它们必须判断哪些页面最重要、网站的主题是什么,以及内容是如何组织的——通常需要爬取许多页面并推断其结构。llms.txt 通过提供明确、机器可读(且人类可读)的摘要来解决这一问题。

编写完善的 llms.txt 的好处:

  1. 加快 AI 理解: AI 系统只需查看一个文件,就能了解网站的用途和结构,无需爬取数十个页面。
  2. 掌控叙述方式: 你可以选择 AI 系统优先查看哪些页面和事实,从而影响它们如何呈现你的品牌。
  3. 提高引用准确性: 参考 llms.txt 的 AI 系统可以针对每个主题引用正确且权威的页面。
  4. 减少失实描述: 明确列出关键信息(价格、功能、地点),可减少 AI 对你的业务产生幻觉。
  5. 抢先采用的优势: 截至 2026 年初,拥有 llms.txt 文件的网站不到 5%,因此它能让你脱颖而出。

llms.txt 规范

文件位置

该文件必须位于域名根目录下:

https://example.com/llms.txt
格式规范

该文件使用 Markdown 格式,并遵循特定约定:

# [Site Name]

> [One-sentence description of what the site/business does. Keep under 200 characters.]

## Docs

- [Page Title](https://example.com/page-url): Concise description of what this page covers and why it matters.
- [Another Page](https://example.com/another-page): Description of content.

## Optional

- [Less Critical Page](https://example.com/optional-page): Description.
详细格式规则

1. 标题(必需)

# Site Name
  • 必须是文件的第一行。
  • 应使用企业或网站的正式名称。
  • 使用 H1 标题格式(单个 #)。

2. 描述(必需)

> Brief description of the site/business
  • 必须紧跟在标题之后。
  • 使用 Markdown 引用块格式(>)。
  • 不超过 200 个字符。
  • 应清晰说明企业的业务内容及服务对象。
  • 避免空泛的营销措辞,务必客观、具体。

3. 主要章节(必需——至少一个)

使用 H2 标题(##)按类别组织页面。常见章节名称:

章节名称用途内容示例
## Docs主要文档或关键页面产品页面、服务说明、核心内容
## Optional值得了解的次要页面博客文章、补充资源
## APIAPI 文档API 参考、身份验证指南
## Blog博客或新闻内容最新/热门文章
## Products产品目录产品页面、定价
## Services服务项目服务说明、流程页面
## About企业信息关于页面、团队、使命
## Resources教育/参考内容指南、教程、白皮书
## Legal法律文件服务条款、隐私政策
## Contact联系信息联系页面、支持渠道

4. 页面条目(必需)

每个条目遵循以下格式:

- [Page Title](URL): Description of page content

页面条目规则:

  • 标题: 使用实际页面标题或清晰的描述性标题。
  • URL: 必须是完整的绝对 URL(不能使用相对路径)。
  • 描述: 用 10-30 个词说明页面内容,并具体描述其中提供的信息。
  • 顺序: 在每个章节内按重要性排列页面。
  • 数量限制: 总共包含 10-30 个页面条目。优先列出最权威、最有用的页面。

5. 关键信息章节(建议)

## Key Facts
- Founded in [year] by [founder(s)]
- Headquarters: [City, Country]
- [X] customers/users in [Y] countries
- Key products: [Product A], [Product B], [Product C]
- Industry: [Industry classification]

本章节提供快速参考信息,方便 AI 系统回答用户有关企业的常见问题。

6. 联系章节(建议)

## Contact
- Website: https://example.com
- Email: [email protected]
- Support: [email protected]
- Phone: +1-555-123-4567
- Address: 123 Main St, City, State, ZIP, Country

llms-full.txt(扩展版)

除了 llms.txt,网站还可以提供 /llms-full.txt——内容更详尽的扩展版。

与 llms.txt 的区别:

特性llms.txtllms-full.txt
长度简洁(50-150 行)全面(150-500+ 行)
页面条目10-30 个关键页面30-100+ 个页面
描述每个条目 10-30 个词每个条目 30-100 个词,可能包含各页面的关键事实
受众供 AI 快速理解供 AI 深入分析
章节3-6 个章节8-15 个章节
关键事实业务层面的事实页面层面的事实和数据点

两个文件可以共存。AI 系统会先检查 llms.txt,然后可能选择加载 llms-full.txt 以深入了解。


分析模式

检查现有的 llms.txt 文件时:

第 1 步:获取文件
  1. 使用 WebFetch 获取 [domain]/llms.txt。
  2. 同时检查 [domain]/llms-full.txt。
  3. 记录 HTTP 状态码:
    • 200: 文件存在——继续验证。
    • 404: 文件不存在——建议生成。
    • 403: 文件存在但被拦截——标记为配置错误。
    • 301/302: 重定向——跟随重定向并记录。
第 2 步:验证格式

检查每个结构元素:

元素检查项缺失时的严重程度
H1 标题存在,且与企业名称一致严重
引用块描述存在、不超过 200 个字符且内容属实高
至少一个 H2 章节存在严重
含 URL 的页面条目至少有 5 个条目高
URL 为绝对地址所有 URL 均使用完整的 https:// 路径高
URL 有效所有 URL 均返回 200 状态码中
描述齐全每个条目在冒号后都有描述中
Key Facts 章节存在且包含业务信息中
联系方式章节存在且至少包含电子邮件地址低
长度合理30-200 行低
Markdown 无错误全文格式正确中
第 3 步:评估内容质量

从以下维度为 llms.txt 评分:

完整性(0-100):

  • 是否涵盖导航中显示的所有主要网站版块?
  • 是否包含最重要或流量最高的页面?
  • 是否存在包含准确业务数据的 Key Facts 章节?
  • 是否包含近期或已更新的内容?

准确性(0-100):

  • 描述是否准确反映页面内容?
  • URL 是否有效且指向正确页面?
  • Key Facts 是否可验证且为最新信息?
  • 业务描述是否准确?

实用性(0-100):

  • AI 系统能否仅通过此文件理解网站的用途?
  • 描述是否足够具体,能区分各个页面?
  • 是否突出显示最值得引用的页面?
  • 组织结构是否合乎逻辑且直观?

llms.txt 总分 =(完整性 * 0.40)+(准确性 * 0.35)+(实用性 * 0.25)

第 4 步:与网站内容进行比较
  1. 爬取网站的主导航和站点地图。
  2. 找出 llms.txt 中未列出的重要页面。
  3. 检查列出的 URL 是否失效或发生重定向。
  4. 核实业务描述是否与当前首页文案一致。
  5. 标记过时条目(自编写 llms.txt 以来已大幅更新的页面)。

生成模式

从头创建新的 llms.txt 文件时:

第 1 步:探索网站
  1. 获取首页并提取:
    • 网站名称(来自 <title>、<meta property="og:site_name"> 或 H1)
    • 业务描述(来自元描述或首屏区域)
    • 主导航链接
    • 页脚链接
  2. 获取 /sitemap.xml,以发现所有公开页面。
  3. 确定网站的主要业务类型(SaaS、电商、本地业务、出版商、代理机构)。
步骤 2:页面优先级排序

对发现的所有页面进行分类,并选出最重要的页面:

始终包含:

  • 首页
  • 关于 / 公司页面
  • 定价页面(如果存在)
  • 主要产品 / 服务页面(前 3–5 个)
  • 联系页面
  • 文档首页(如果存在)

如质量较高,则包含:

  • 热门博客文章(根据其重要性、时效性或全面性判断)
  • 案例研究或客户故事
  • 关键资源 / 指南页面
  • 常见问题页面
  • 招聘页面(适用于大型公司)

跳过:

  • 内容单薄的分类 / 标签页面
  • 分页页面
  • 登录 / 注册页面
  • 法律声明模板内容(除非与主题特别相关)
  • 重复或近似重复的内容
  • 独特内容极少的页面
步骤 3:撰写描述

针对每个选定的页面:

  1. 使用 WebFetch 获取页面内容。
  2. 阅读 H1、元描述和前 2–3 段。
  3. 撰写一段描述,要求:
    • 长度为 10–30 个词
    • 说明页面包含哪些信息
    • 提及涵盖的具体主题、数据或功能
    • 避免使用营销语言(“最佳”“领先”“革命性”)
    • 使用客观、信息丰富的语言

好的描述示例:

  • 介绍三个定价层级(Free、Pro、Enterprise),并比较功能及按年 / 按月计费的费用。
  • 介绍公司于 2018 年创立、拥有 45 名员工,以及位于 Austin 和 London 的办公地点。
  • 介绍 Slack、Salesforce 和 HubSpot 的集成设置,包含分步指南和 API 端点。

不好的描述示例:

  • 我们超棒的定价页面!(营销语言,没有具体内容)
  • 进一步了解我们的公司。(过于笼统)
  • 点击此处了解详情。(缺少描述性)
步骤 4:汇总关键事实

从网站收集关键业务信息:

  • 创立年份
  • 创始人姓名
  • 总部所在地
  • 员工人数(如公开)
  • 客户 / 用户数量(如公开)
  • 主要产品或服务(列出前 3–5 项)
  • 行业分类
  • 知名客户或合作伙伴(如公开)
  • 关键差异化优势(该企业的独特之处)
  • 近期里程碑或成就(过去 12 个月内)
步骤 5:组装文件

按照以下模板构建 llms.txt:

# [Site Name]

> [One clear sentence: what the business does, who it serves, and its primary value proposition. Under 200 characters.]

## Docs

- [Most Important Page](https://example.com/page): Description covering the key content on this page.
- [Second Page](https://example.com/page-2): Description of this page's content and value.
- [Third Page](https://example.com/page-3): What users and AI systems will find here.

## Products

- [Product A](https://example.com/product-a): Core features, target users, and pricing model for Product A.
- [Product B](https://example.com/product-b): What Product B does and how it differs from Product A.

## Resources

- [Guide Title](https://example.com/guide): Comprehensive guide covering [topic] with [X] sections and practical examples.
- [Blog Post](https://example.com/blog/post): Analysis of [topic] with original data from [source].

## Key Facts

- Founded in [year] by [name(s)]
- Headquartered in [City, Country]
- [Specific metric: e.g., "Serves 10,000+ businesses in 40 countries"]
- [Key differentiator: e.g., "Only platform offering real-time X and Y integration"]
- Industry: [Classification]

## Contact

- Website: https://example.com
- Email: [primary contact email]
- Support: [support URL or email]
步骤 6:验证生成的文件

输出前:

  1. 验证所有 URL 均可访问(状态码为 200)。
  2. 确认条目总数在 10–30 之间。
  3. 检查描述是否均不超过 50 个词。
  4. 验证文件总长度在 50–150 行之间。
  5. 确保 Markdown 格式整洁、一致。

输出格式

分析模式

生成 GEO-LLMSTXT-ANALYSIS.md:

# llms.txt Analysis: [Domain]

**Analysis Date:** [Date]
**llms.txt Status:** [Found at URL / Not Found / Error]
**llms-full.txt Status:** [Found / Not Found]

---

## Overall llms.txt Score: [X]/100

| Dimension | Score |
|---|---|
| Completeness | [X]/100 |
| Accuracy | [X]/100 |
| Usefulness | [X]/100 |

---

## Format Validation

| Element | Status | Notes |
|---|---|---|
| H1 Title | [Pass/Fail] | [Notes] |
| Description blockquote | [Pass/Fail] | [Notes] |
| H2 Sections | [Pass/Fail] | [X sections found] |
| Page entries | [Pass/Fail] | [X entries found] |
| URL validity | [Pass/Fail] | [X broken URLs] |
| Entry descriptions | [Pass/Fail] | [X missing descriptions] |
| Key Facts | [Pass/Fail] | [Notes] |
| Contact section | [Pass/Fail] | [Notes] |

---

## Missing Pages

These important pages were found on the site but not in llms.txt:

1. [Page Title](URL) -- [Why it should be included]
2. [Page Title](URL) -- [Why it should be included]

## Improvement Recommendations

1. [Specific recommendation]
2. [Specific recommendation]
3. [Specific recommendation]

## Suggested Updated llms.txt

[Complete rewritten llms.txt file if significant improvements are needed]
生成模式

输出完整的 llms.txt 文件内容,以便保存到网站根目录。另请输出一份简短的 GEO-LLMSTXT-GENERATION.md 报告,说明:

  • 发现了多少个页面,选出了多少个页面
  • 页面优先级排序的依据
  • 有哪些页面处于边缘,可能会在之后添加
  • 建议的更新频率(例如,活跃博客每月更新,稳定网站每季度更新)

最佳实践参考

  1. 定期更新。 如果你的网站每周发布博客文章,每月更新一次 llms.txt。如果你的产品每季度更新,则在每次发布后更新。
  2. 优先列出最优质的内容。 每个部分中的前几项应是最权威、最全面的页面。
  3. 描述要具体。 “一篇包含代码示例、长达 3,000 字的 React Server Components 综合指南”远比“React 指南”更有用。
  4. 突出你的差异化优势。 如果你的网站拥有独特数据、原创研究或专属功能,请在描述和关键事实中重点说明。
  5. 保持简洁。 llms.txt 应能在 60 秒内快速浏览完毕。详细内容留给 llms-full.txt。
  6. 使用绝对 URL。 始终包含完整的 https:// URL,切勿使用相对路径。
  7. 部署后进行测试。 上传后,确认文件可通过 https://yourdomain.com/llms.txt 访问,且不会发生重定向。
  8. 与 robots.txt 协调。 确保 robots.txt 不会阻止 AI 爬虫访问 llms.txt 中列出的页面。
  9. 与网站结构保持一致。 llms.txt 中的部分名称应大致对应网站主导航中的类别。
  10. 避免列出敏感页面。 不要包含内部工具、管理面板或含有敏感信息的页面。

评论

支持 Markdown