2026-11-12 · PM 出稿 · 配套需求文档:docs/design/seo/QUICK-WINS-PRD.md

Funyard SEO 第一步:先做 4 件小事

这页用大白话讲清楚 4 件事:它们各是什么、为什么要做、做完有什么变化、你自己要做什么。文中标 已核实 的是 2026-11-12 实测或读代码得到的事实;标 建议 的是 PM 的方案;标 未能核实 的写了原因。

一句话结论

现在的 funyard.org,在搜索引擎和 AI 眼里几乎是一张白纸。打开任何网址,它们都只拿到一个 477 字节、标题叫「FunYard」、正文为空的网页。这 4 件事做完,它们至少能读到每个页面是干什么的,并且知道哪些页面该看、哪些不该看。这是之后所有 SEO 工作的地基。

  1. 搜索引擎和 AI 怎么「看」网站
  2. 现在的 Funyard 在爬虫眼里
  3. 第 1 件:robots / sitemap / llms 三个文件
  4. 第 2 件:真正的 404
  5. 第 3 件:每页自己的标题和描述
  6. 第 4 件:分享卡片
  7. 做完之后还差什么
  8. 你自己要做的事
  9. 需要你拍板的问题
  10. 术语小词典

搜索引擎和 AI 是怎么「看」一个网站的

可以把它想成图书馆收书:

① 爬虫来访 Googlebot、GPTBot… 先看 robots.txt ② 读 HTML 标题、描述、正文 (很多不执行 JS) ③ 收录 放进自己的「书架」 也叫建索引 ④ 有人搜索时 展示标题 + 描述 或被 AI 引用 书架管理员上门 翻开书看封面和目录 登记上架 读者来借时推荐 Funyard 今天卡在第②步:翻开书,里面是空白页

关键点:很多爬虫不运行网页里的 JavaScript,只看服务器第一次发回来的那段 HTML 文本。Google 会排队把 JS 跑一遍,但更慢、不保证每次都跑。Bing 跑得少。ChatGPT、Claude 这类 AI 爬虫基本不跑。

现在的 Funyard 在爬虫眼里是什么样 已核实

爬虫拿到的(服务器原样返回,477 字节)
<!doctype html>
<html lang="zh-CN"><head>
<meta charset="UTF-8">
<meta name="viewport" content="…">
<meta name="theme-color" content="#2457E8">
<link rel="icon" href="/assets/brand/funyard-symbol-blue.svg">
<title>FunYard</title>
<script type="module" src="/assets/index-CV9kL18j.js"></script>
<link rel="stylesheet" href="/assets/index-BLJszE6I.css">
</head><body><div id="root"></div></body></html>

只有一个标题「FunYard」,没有描述,正文是空的 <div id="root">。Googlebot、Bingbot、GPTBot、ClaudeBot 拿到的内容逐字节相同。

你在浏览器里看到的

完整的首页:品牌标语「一个 Key,接入数据与工具」、Agent 接入演示动画、数据来源墙、案例、去目录和文档的按钮……

这些全是浏览器下载约 157KB(压缩后)的 JavaScript 后现场画出来的。不跑 JS 的读者看不到。

另外几个实测事实:

第 1 件:加 robots.txt、sitemap.xml、llms.txt 三个文件

这是什么

三张贴在门口的说明:

现在的问题 已核实

三个文件都不存在,爬虫来要时拿到的是一张空白网页。爬虫不知道哪些该看、哪些不该看,也没有现成的简介可读。

做完之后

前后对比:robots.txt 节选(定稿)

User-agent: *
Allow: /
Disallow: /dashboard
Disallow: /login
Disallow: /account/
Disallow: /cli/
Disallow: /admin
Disallow: /api/
Disallow: /funyard/
…
Sitemap: https://funyard.org/sitemap.xml

对 AI 爬虫:建议 全部放行,不单独写规则。我们的用户就是用 AI 的人,AI 能读到并推荐 FunYard 就是曝光。能读到的只有三个公开页面,账户和接口本来就禁止,也有登录保护。是否放行需要你拍板,见文末。

llms.txt 开头节选(定稿,英文)

# FunYard

> FunYard gives AI agents one key for data and tools: web and news search,
  company and people profiles, stock, crypto and economic data, and public
  social media accounts. Agents connect through the FunYard CLI, a JavaScript
  SDK, a local stdio MCP server or plain HTTP.

FunYard is currently in beta. Using it requires a FunYard beta account; …

## Get started
- [Setup guide](https://funyard.org/docs): …
- [Agent installation guide](https://funyard.org/SKILL.md): …

只写已公开、有验收记录的 18 个能力,不写供应商名字,不写还没做的东西。全文见需求文档第 3 节。

sitemap.xml 收什么

只收 3 个:https://funyard.org/、/catalog、/docs。登录、控制台这些不收;带 ?lang=en 的也不收,因为和原网址是同一个页面。

第 2 件:不存在的地址返回真正的 404

这是什么

类比:有人按门牌号找「302 房间」,但楼里根本没有 302。正确做法是门卫说「没有这个房间」(404)。现在门卫的做法是把人领进大厅,说「到了」(200)。

现在的问题 已核实

做完之后

首页、目录、文档、登录、控制台等真实页面照常打开。其它不存在的地址返回 404 状态码。用户看到的仍是现在那个「页面不存在」提示,体验不变。图片、脚本、接口、客服组件都不受影响。

前后对比示意

访问现在做完
/docs200200
/catalog?view=tasks200200
/pricing(还没有这个页)200404
/this-page-does-not-exist-xyz200404
/assets/nope.png200(还是网页)404
/admin(未登录)404404(不动)

第 3 件:首页、目录、文档各有自己的标题和描述

这是什么

类比:每本书的书脊和封底简介。标题(title)就是搜索结果里那行蓝色大字;描述(meta description)是下面那两行灰色小字。读者靠这两样决定点不点。

现在的问题 已核实

做完之后

服务器发出的 HTML 里,每页就有自己的标题、描述和「规范网址」(canonical,告诉搜索引擎这一页的标准地址是哪个)。不跑 JS 也看得到。

前后对比:搜索结果模拟(示意)

现在(假设被收录)
funyard.org
FunYard
此网页没有提供说明。

没有描述时,搜索引擎会从正文里挑文字。我们的正文是空的,所以大概率什么也挑不出来。

做完(中文默认版)
funyard.org
FunYard:一个 Key 让 Agent 接入数据与工具
给你的 AI Agent 一个 Key,接入网页搜索、新闻、企业、金融、加密货币与公开社交数据,通过 CLI 或 MCP 连接。

三个页面定稿文案

字数上限:英文标题 60、描述 155;中文减半。超出部分在搜索结果里会被截成「…」。

页面语言标题描述
首页中FunYard:一个 Key 让 Agent 接入数据与工具 (30)给你的 AI Agent 一个 Key,接入网页搜索、新闻、企业、金融、加密货币与公开社交数据,通过 CLI 或 MCP 连接。 (64)
英FunYard — One Key for Your AI Agent's Data and Tools (52)Give your AI agent one key for web search, news, company, finance, crypto and public social data. Connect with the CLI or MCP. (126)
目录中数据与工具目录 — FunYard (17)浏览 FunYard 已发布的能力:网页与新闻搜索、企业与职业资料、股票、加密货币、宏观经济与公开社交账号数据。 (56)
英Data and Tool Catalog for AI Agents — FunYard (45)Browse FunYard's published capabilities: web and news search, company and people profiles, stocks, crypto, economic data and public social accounts. (148)
文档中接入文档:用 CLI 或 MCP 连接 FunYard (27)从 npm 安装 FunYard CLI 并在浏览器授权,Codex、Claude Code 或任意 MCP 客户端即可用一个 Key 调用数据与工具。 (76)
英Connect Your Agent to FunYard: CLI and MCP Setup (48)Install the FunYard CLI from npm, approve access in your browser, then let Codex, Claude Code or any MCP host call data and tools with one key. (143)

一个限制:中文和英文现在共用同一个网址(靠 ?lang=en 或浏览器记忆切换)。服务器只能先给爬虫一种语言,所以搜索结果里只会出现默认语言那一版。默认用中文还是英文,需要你拍板。文案已经按「改一个值就切换」准备好了。

第 4 件:分享卡片

这是什么

类比:名片。把链接发到飞书、Slack、X 时,对方看到的不是一串网址,而是一张带图、标题和简介的小卡片。技术名叫 Open Graph(OG)和 Twitter 卡片,是写在网页头部的几行标签。

现在的问题 已核实

网页里一行这类标签都没有。另外,品牌素材目录里只有 SVG 格式的标志,而大部分聊天软件和社交平台不支持 SVG 当分享图,所以需要设计专门出一张 1200×630 的 PNG。

做完之后

三个页面都有自己的卡片标题和简介,配同一张品牌分享图。

前后对比示意(聊天软件里)

现在
https://funyard.org/docs

可能只显示一个光秃秃的链接,或只显示「FunYard」几个字。不同软件表现略有差异。

做完(图为示意,正式图待设计)
https://funyard.org/docs

分享图规格:1200×630 PNG,≤300KB,品牌蓝或白底,放标志加现有标语「One key for data and tools. / 一个 Key,接入数据与工具。」,重要文字放在中间(有的平台会裁边)。不放截图、价格、客户或供应商标志。

做完这 4 项之后还差什么

还差是什么为什么放后面
正文预渲染让首页文案、目录列表也直接出现在服务器返回的 HTML 里改造量大,要动渲染方式。先用标题、描述和 llms.txt 拿到最基本的可见性
英文独立网址例如 /en/docs,中英文各一个地址,互相标注(hreflang)先要你定「主攻哪种语言」
能力落地页例如「金融数据」「社交数据」各一个页面,对应别人会搜的词要先有预渲染才有意义;内容必须遵守「只公开有验收记录的能力」
价格 / 隐私 / 条款页现在都不存在是产品和法务内容,要单独立需求
结构化数据给搜索引擎看的机器可读标签(JSON-LD)有能力页、价格页之后再做,收益更大

你自己要做的事(都免费,约 30–60 分钟)

为什么要你亲自做:这几步要用到你的 Google / 微软账号和 Cloudflare 后台,只有域名主人能操作。建议等这个 PR 上线后再做第 1、2 步,这样能直接提交 sitemap。第 3 步现在就可以做。

1. 注册 Google Search Console

作用:看 Google 收录了哪些页面、别人搜什么词看到了你、有什么错误。

  1. 打开 search.google.com/search-console,用你的 Google 账号登录。
  2. 添加资源(property),选左边的「网域」(Domain)类型,输入 funyard.org,不带 https、不带 www。(选「网域」可以一次覆盖 http/https、带不带 www 的所有地址。)
  3. 它会给你一串 google-site-verification=…… 的 TXT 记录值,复制下来。
  4. 另开一个标签页登录 Cloudflare → 选 funyard.org → 左侧 DNS → Records → Add record:
    • Type 选 TXT
    • Name 填 @
    • Content 粘贴刚才那串值
    • 保存
  5. 回到 Search Console 点「验证」(Verify)。显示成功即可。若失败,等几分钟到几小时再点,Google 说最长可能要两三天。这条记录以后不要删,删了就会失去验证。
  6. 验证后,左侧菜单进「站点地图」(Sitemaps),输入 sitemap.xml,点提交。状态显示「成功」即可。
  7. 可选:在顶部搜索框输入 https://funyard.org/(即「网址检查」URL Inspection),点「请求编入索引」。

官方说明:添加资源 · 验证网站所有权 · 站点地图报告 · 网址检查工具。菜单名以页面实际显示为准,中英文界面名称略有不同。

怎么确认成功:几天后「网页」(Pages)报告里出现「已编入索引」的页面;一两周后「效果」(Performance)里开始有展示次数。

2. 注册 Bing Webmaster Tools

作用:Bing 的收录数据。现在 Bing 对 funyard.org 是 0 收录。

  1. 打开 bing.com/webmasters,用微软或 Google 账号登录。
  2. 欢迎页有两个选项。推荐选「从 Google Search Console 导入」:授权后会自动带入已验证的 funyard.org 和 sitemap,不用再加 DNS 记录。所以先做完第 1 步。
  3. 如果选手动添加,填 https://funyard.org,按提示选 DNS 验证(同样去 Cloudflare 加一条 Bing 给的记录),或选它提供的其他方式。
  4. 进入 Sitemaps,提交 https://funyard.org/sitemap.xml。

未能核实 Bing 的帮助页是动态页面,抓取不到正文,以上按钮名以实际页面为准。官方帮助入口:添加和验证网站。

3. 在 Cloudflare 里检查两个开关(现在就能做)

a. 让 http 自动跳到 https 已核实问题

实测:http://funyard.org/docs 直接返回页面,没有跳到 https。这会让同一页出现两个地址,也不安全。

  1. Cloudflare → funyard.org → SSL/TLS → Overview,确认加密模式不是 Off。
  2. SSL/TLS → Edge Certificates,打开 Always Use HTTPS。
  3. 确认:浏览器打开 http://funyard.org/docs,地址栏应自动变成 https。

官方说明:Always Use HTTPS

b. 看一眼 AI 爬虫是否被拦 未能核实

我们用伪造身份测试时 AI 爬虫能进,但 Cloudflare 是按真实来源 IP 识别爬虫的,伪造测试证明不了真爬虫没被挡。

  1. Cloudflare → funyard.org → Security → Settings,筛选 Bot traffic。
  2. 打开 AI Crawler and Agent access policies,看 Search / Agent / Training 三项。若按推荐「全部放行」,三项都应是 Allow。
  3. 截图发给总控即可,不确定就先别改。

官方说明:AI Crawler and Agent access policies

4. 上线后试发一次链接

把 https://funyard.org/?v=1 分别发到飞书、Slack、X 的输入框(不用真的发出去),看有没有出现带图的卡片。加 ?v=1 是为了绕过平台对旧卡片的缓存。

需要你拍板的问题

产品决策

  1. 主攻英文搜索还是中文搜索?
    推荐 长期主攻英文:做 Agent 的开发者主要用英文搜索,同类网站也都是英文,AI 读英文最好。但本 PR 先保持中文默认,因为现在网页正文默认是中文,标题和正文语言要一致。你一旦定了英文,只需改一个值。代价是中文用户第一次打开会看到英文页,所以要你明确同意。
  2. AI 爬虫是否全部放行?
    推荐 放行。被 AI 引用是我们最想要的曝光。若你不想让公开文案进入模型训练,可以只挡「训练类」爬虫(如 GPTBot、Google-Extended、CCBot),保留「检索类」。代价是被 AI 推荐的机会变少。
  3. llms.txt 里写「目前是内测、需要内测账号、按点计费」可以吗?
    推荐 可以。文档页已经公开写了「登录内测账号」。
  4. FunYard 有官方 X(推特)账号吗?
    有就告诉我,写进分享卡片;没有就先不写。

开发决策(开发定,供你知悉)

交集不清楚(需要总控 / 你排期)

术语小词典

爬虫(crawler / bot)
搜索引擎或 AI 公司派出的自动程序,挨个访问网页、把内容带回去。例如 Googlebot、Bingbot、GPTBot(OpenAI)、ClaudeBot(Anthropic)。
收录 / 索引(index)
搜索引擎把一个网页登记进自己的数据库。没收录的页面,搜什么都搜不到。
robots.txt
放在网站根目录的一个文本文件,告诉爬虫哪些路径可以访问、哪些不要访问。它是告示,不是门锁。
sitemap(站点地图)
一个列出网站重要网址的 XML 文件,帮助搜索引擎更快发现页面。
title(网页标题)
浏览器标签页上的文字,也是搜索结果里那行蓝色大字。
meta description(网页描述)
写在网页头部的一两句介绍,搜索结果里标题下面的灰色小字通常就用它。
canonical(规范网址)
告诉搜索引擎「这一页的标准地址是哪个」,避免 /docs 和 /docs?lang=en 被当成两个重复页面。
Open Graph / Twitter 卡片
网页头部的几行标签,决定链接分享到聊天软件和社交平台时显示的标题、简介和图片。
404
服务器回答「这个地址不存在」的标准状态码。200 表示「成功找到」。
软 404(soft 404)
页面明明不存在,服务器却回答 200。搜索引擎会把它当作低质量的重复页。
llms.txt
2024 年出现的一个约定:在网站根目录放一份写给大语言模型看的 Markdown 简介,方便 AI 快速理解网站。还不是正式标准,但做起来很便宜。参考:llmstxt.org。
客户端渲染(CSR)/ 预渲染
客户端渲染:服务器只发空壳,由浏览器跑 JS 把页面画出来,Funyard 现在就是这样。预渲染:服务器直接发出画好的页面,爬虫不跑 JS 也能读到正文。
hreflang
告诉搜索引擎「这一页还有其他语言版本,地址分别是什么」的标签。需要每种语言有独立网址才能用。
Search Console / Bing Webmaster Tools
Google 和微软给网站主人的免费后台,看收录、搜索词、错误,并提交 sitemap。

本页数据来自 2026-11-12 对 funyard.org 的少量只读请求,以及仓库 origin/main(88f0a48)的代码。不含任何密钥或个人信息。