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 工作的地基。
- 搜索引擎和 AI 怎么「看」网站
- 现在的 Funyard 在爬虫眼里
- 第 1 件:robots / sitemap / llms 三个文件
- 第 2 件:真正的 404
- 第 3 件:每页自己的标题和描述
- 第 4 件:分享卡片
- 做完之后还差什么
- 你自己要做的事
- 需要你拍板的问题
- 术语小词典
搜索引擎和 AI 是怎么「看」一个网站的
可以把它想成图书馆收书:
关键点:很多爬虫不运行网页里的 JavaScript,只看服务器第一次发回来的那段 HTML 文本。Google 会排队把 JS 跑一遍,但更慢、不保证每次都跑。Bing 跑得少。ChatGPT、Claude 这类 AI 爬虫基本不跑。
现在的 Funyard 在爬虫眼里是什么样 已核实
<!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 的读者看不到。
另外几个实测事实:
/robots.txt、/sitemap.xml、/llms.txt都不存在。访问它们也拿到上面那张空白页,状态还是「200 成功」。- 随便编一个网址,比如
/this-page-does-not-exist-xyz、/pricing,同样返回「200 成功」加空白页。 - 在 Bing 搜
site:funyard.org,结果是 There are no results,一个页面都没收录。Google 的情况 未能核实:需要你注册 Search Console 后才看得到真实数据。
第 1 件:加 robots.txt、sitemap.xml、llms.txt 三个文件
这是什么
三张贴在门口的说明:
- robots.txt 是门卫告示:「欢迎参观大厅、展厅、说明书区;员工办公室请勿入内。」
- sitemap.xml 是楼层导览图:「我们值得看的房间就这三间,地址如下。」
- llms.txt 是给 AI 的一页纸简介:用 AI 最好读的纯文本,讲清「我们是谁、能做什么、怎么接入」。
现在的问题 已核实
三个文件都不存在,爬虫来要时拿到的是一张空白网页。爬虫不知道哪些该看、哪些不该看,也没有现成的简介可读。
做完之后
- 爬虫只看首页、目录、文档;登录、控制台、后台、接口一律不进。
- Google、Bing 拿到三个规范网址,在 Search Console 里能看到收录进度。
- AI 读到一页英文简介,里面有产品介绍、18 个公开能力、CLI/MCP 怎么接,以及给 Agent 的安装指南链接
/SKILL.md。这个链接已上线。
前后对比: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)。
现在的问题 已核实
/pricing、/privacy、/terms、随便编的网址,甚至不存在的图片/assets/nope.png,全部返回「200 成功」。- 后果一:搜索引擎会把一堆不存在的网址当成「重复的空页面」,浪费它给我们的抓取次数,也拉低对整站质量的判断。Google 把这叫「软 404」。
- 后果二:以后链接写错了,我们自己也发现不了。
做完之后
首页、目录、文档、登录、控制台等真实页面照常打开。其它不存在的地址返回 404 状态码。用户看到的仍是现在那个「页面不存在」提示,体验不变。图片、脚本、接口、客服组件都不受影响。
前后对比示意
| 访问 | 现在 | 做完 |
|---|---|---|
/docs | 200 | 200 |
/catalog?view=tasks | 200 | 200 |
/pricing(还没有这个页) | 200 | 404 |
/this-page-does-not-exist-xyz | 200 | 404 |
/assets/nope.png | 200(还是网页) | 404 |
/admin(未登录) | 404 | 404(不动) |
第 3 件:首页、目录、文档各有自己的标题和描述
这是什么
类比:每本书的书脊和封底简介。标题(title)就是搜索结果里那行蓝色大字;描述(meta description)是下面那两行灰色小字。读者靠这两样决定点不点。
现在的问题 已核实
- 服务器发出的 HTML 里,三个页面的标题都是「FunYard」四个字母,没有描述。
- JS 运行后标题会变成「FunYard — 为 Agent 接入数据与工具」,但三个页面还是同一个。
- 不跑 JS 的爬虫连这一句都看不到。
做完之后
服务器发出的 HTML 里,每页就有自己的标题、描述和「规范网址」(canonical,告诉搜索引擎这一页的标准地址是哪个)。不跑 JS 也看得到。
前后对比:搜索结果模拟(示意)
没有描述时,搜索引擎会从正文里挑文字。我们的正文是空的,所以大概率什么也挑不出来。
三个页面定稿文案
字数上限:英文标题 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。
做完之后
三个页面都有自己的卡片标题和简介,配同一张品牌分享图。
前后对比示意(聊天软件里)
可能只显示一个光秃秃的链接,或只显示「FunYard」几个字。不同软件表现略有差异。
分享图规格: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 收录了哪些页面、别人搜什么词看到了你、有什么错误。
- 打开 search.google.com/search-console,用你的 Google 账号登录。
- 添加资源(property),选左边的「网域」(Domain)类型,输入
funyard.org,不带 https、不带 www。(选「网域」可以一次覆盖 http/https、带不带 www 的所有地址。) - 它会给你一串
google-site-verification=……的 TXT 记录值,复制下来。 - 另开一个标签页登录 Cloudflare → 选
funyard.org→ 左侧 DNS → Records → Add record:- Type 选
TXT - Name 填
@ - Content 粘贴刚才那串值
- 保存
- Type 选
- 回到 Search Console 点「验证」(Verify)。显示成功即可。若失败,等几分钟到几小时再点,Google 说最长可能要两三天。这条记录以后不要删,删了就会失去验证。
- 验证后,左侧菜单进「站点地图」(Sitemaps),输入
sitemap.xml,点提交。状态显示「成功」即可。 - 可选:在顶部搜索框输入
https://funyard.org/(即「网址检查」URL Inspection),点「请求编入索引」。
官方说明:添加资源 · 验证网站所有权 · 站点地图报告 · 网址检查工具。菜单名以页面实际显示为准,中英文界面名称略有不同。
怎么确认成功:几天后「网页」(Pages)报告里出现「已编入索引」的页面;一两周后「效果」(Performance)里开始有展示次数。
2. 注册 Bing Webmaster Tools
作用:Bing 的收录数据。现在 Bing 对 funyard.org 是 0 收录。
- 打开 bing.com/webmasters,用微软或 Google 账号登录。
- 欢迎页有两个选项。推荐选「从 Google Search Console 导入」:授权后会自动带入已验证的 funyard.org 和 sitemap,不用再加 DNS 记录。所以先做完第 1 步。
- 如果选手动添加,填
https://funyard.org,按提示选 DNS 验证(同样去 Cloudflare 加一条 Bing 给的记录),或选它提供的其他方式。 - 进入 Sitemaps,提交
https://funyard.org/sitemap.xml。
未能核实 Bing 的帮助页是动态页面,抓取不到正文,以上按钮名以实际页面为准。官方帮助入口:添加和验证网站。
3. 在 Cloudflare 里检查两个开关(现在就能做)
a. 让 http 自动跳到 https 已核实问题
实测:http://funyard.org/docs 直接返回页面,没有跳到 https。这会让同一页出现两个地址,也不安全。
- Cloudflare →
funyard.org→ SSL/TLS → Overview,确认加密模式不是 Off。 - SSL/TLS → Edge Certificates,打开 Always Use HTTPS。
- 确认:浏览器打开
http://funyard.org/docs,地址栏应自动变成 https。
官方说明:Always Use HTTPS
b. 看一眼 AI 爬虫是否被拦 未能核实
我们用伪造身份测试时 AI 爬虫能进,但 Cloudflare 是按真实来源 IP 识别爬虫的,伪造测试证明不了真爬虫没被挡。
- Cloudflare →
funyard.org→ Security → Settings,筛选 Bot traffic。 - 打开 AI Crawler and Agent access policies,看 Search / Agent / Training 三项。若按推荐「全部放行」,三项都应是 Allow。
- 截图发给总控即可,不确定就先别改。
4. 上线后试发一次链接
把 https://funyard.org/?v=1 分别发到飞书、Slack、X 的输入框(不用真的发出去),看有没有出现带图的卡片。加 ?v=1 是为了绕过平台对旧卡片的缓存。
需要你拍板的问题
产品决策
- 主攻英文搜索还是中文搜索?
推荐 长期主攻英文:做 Agent 的开发者主要用英文搜索,同类网站也都是英文,AI 读英文最好。但本 PR 先保持中文默认,因为现在网页正文默认是中文,标题和正文语言要一致。你一旦定了英文,只需改一个值。代价是中文用户第一次打开会看到英文页,所以要你明确同意。 - AI 爬虫是否全部放行?
推荐 放行。被 AI 引用是我们最想要的曝光。若你不想让公开文案进入模型训练,可以只挡「训练类」爬虫(如 GPTBot、Google-Extended、CCBot),保留「检索类」。代价是被 AI 推荐的机会变少。 - llms.txt 里写「目前是内测、需要内测账号、按点计费」可以吗?
推荐 可以。文档页已经公开写了「登录内测账号」。 - FunYard 有官方 X(推特)账号吗?
有就告诉我,写进分享卡片;没有就先不写。
开发决策(开发定,供你知悉)
- 实现方式:推荐 只改 Worker 代码,不改生产配置文件
wrangler.production.jsonc。改那个文件会触发发布门禁,要单独验收。 - 给 llms.txt 加个自动检查,防止以后误写进未验收的能力。推荐 加。
交集不清楚(需要总控 / 你排期)
- 上线时间 已核实:线上目前停在 11-09 的版本(
2782ec3)。主干上 PR #96(后台用户备注)带了一项待验收的数据库改动,按规则在它验收前,后面合入的任何 PR 都不会自动上线。这个 SEO 改动合入后,要等 #96 验收完成才会生效。 - 分享图:推荐 派 design 出图。图没好之前,能否先上线不带图的版本?
术语小词典
- 爬虫(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)的代码。不含任何密钥或个人信息。