diff --git a/.gitignore b/.gitignore index 0d886c8..363d1fc 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1 @@ -/backend/.env* - -/docs \ No newline at end of file +/backend/.env* \ No newline at end of file diff --git a/docs/seo-guide.md b/docs/seo-guide.md new file mode 100644 index 0000000..a7cb551 --- /dev/null +++ b/docs/seo-guide.md @@ -0,0 +1,313 @@ +# SeeForMe SEO 优化实战指南 + +> 适用版本:Expo (React Native) + FastAPI +> 目标:让 Google / Bing / 百度等搜索引擎抓取到产品,提升自然流量与品牌曝光。 + +--- + +## 一、核心思路 + +移动 App 本身无法被搜索引擎直接抓取,SEO 的本质是**在 Web 端建立可被爬虫索引的入口**,再通过 App Store / Google Play 的 ASO(应用商店优化)覆盖搜索流量。 + +两条并行主线: + +| 方向 | 效果 | 优先级 | +|------|------|--------| +| 应用商店优化 (ASO) | 应用内搜索 + 商店首页推荐 | ⭐⭐⭐⭐⭐ | +| Web 落地页 SEO | Google 自然搜索排名 | ⭐⭐⭐⭐ | +| Expo Web 路由 SEO | 用户分享链接可被收录 | ⭐⭐⭐ | + +--- + +## 二、应用商店优化(ASO) + +### 2.1 标题与副标题 + +- **App Store(iOS)** + - 标题(30 字符限制):`为你所见 · 盲人视觉助手` + - 副标题(30 字符):`实时志愿者视频陪伴服务` + +- **Google Play(Android)** + - 标题(50 字符):`为你所见 SeeForMe - 视障人士视觉助手` + - 简介(80 字符):`连接志愿者,让视障者实时"看见"世界` + +> 规则:标题中包含核心关键词,但不可堆砌。 + +### 2.2 关键词策略 + +优先布局在**描述前三行(可见区域)**和关键词字段(仅 App Store 有 100 字符关键词字段): + +``` +主关键词(高意图): +- 盲人辅助工具 +- 视障助手 App +- 盲人视频通话志愿者 + +长尾关键词(低竞争): +- 视觉障碍日常生活帮助 +- 公益志愿者帮助盲人 +- 实时视频描述场景 +``` + +### 2.3 描述文案(完整描述 4000 字符) + +第一段(前三行必须吸引眼球,无需展开就能看到): + +``` +当你需要时,有人替你看见。 +SeeForMe 连接有需要的视障朋友与热心志愿者, +通过实时视频,志愿者帮你描述周围的世界——无论是读菜单、 +看路牌、还是感受草原的辽阔。 +``` + +### 2.4 截图与预览视频 + +- 截图数量:**iOS 最多 10 张,Android 最多 8 张** +- 前 3 张放最核心功能截图,配上中文说明文字 +- 拍摄 **30 秒预览视频**:展示发起求助 → 志愿者接单 → 实时视频描述全流程 +- 文件格式:PNG(截图)/ MP4(视频) + +### 2.5 评分与评论 + +- 在用户完成一次成功的志愿服务后弹出评分请求(`expo-store-review`) +- 目标:保持 4.5 星以上 +- 及时回复差评,展示团队活跃度 + +--- + +## 三、Web 落地页 SEO + +> 落地页是搜索引擎抓取的主要入口,建议独立部署(如 Vercel / Cloudflare Pages)或复用 Expo Web 构建。 + +### 3.1 页面结构(最小可行) + +``` +/ (首页) ← 核心关键词着陆页 +/about ← 项目介绍 + 团队 +/how-it-works ← 功能说明(志愿者视角 / 求助者视角) +/volunteer ← 志愿者招募页(转化页) +/blog ← SEO 内容输出(长期) +/sitemap.xml ← 站点地图 +/robots.txt ← 爬虫规则 +``` + +### 3.2 HTML 元数据(每个页面必填) + +```html + +SeeForMe 为你所见 — 连接盲人与志愿者的视觉助手 + + + + + + + + + + + + + + + + + +``` + +### 3.3 在 Expo Web 中添加元数据 + +Expo Router 支持通过 `expo-router/head` 在每个路由文件里设置 `` 内容: + +```tsx +// frontend/app/(public)/welcome.tsx (示例片段) +import { Stack } from "expo-router"; + +export default function WelcomePage() { + return ( + <> + + {/* 页面内容 */} + + ); +} +``` + +对于 Web 专属的 `` 标签,在 `app/_layout.tsx` 中通过 `expo-router/head` 的 `` 组件注入: + +```tsx +// frontend/app/_layout.tsx (新增 web 专属 head) +import { Head } from "expo-router/head"; +import { Platform } from "react-native"; + +// 在 RootLayout 返回值中加入(只在 web 渲染): +{Platform.OS === "web" && ( + + + + + +)} +``` + +### 3.4 结构化数据(JSON-LD) + +在首页 `` 内嵌入,帮助 Google 显示富搜索结果: + +```html + +``` + +### 3.5 robots.txt + +在落地页根目录放置: + +``` +User-agent: * +Allow: / +Disallow: /api/ + +Sitemap: https://seeforme.app/sitemap.xml +``` + +### 3.6 sitemap.xml + +```xml + + + + https://seeforme.app/ + weekly + 1.0 + + + https://seeforme.app/how-it-works + monthly + 0.8 + + + https://seeforme.app/volunteer + monthly + 0.8 + + +``` + +--- + +## 四、技术 SEO 检查清单 + +| 项目 | 要求 | 工具 | +|------|------|------| +| HTTPS | 全站启用 | Cloudflare / 域名服务商 | +| Core Web Vitals | LCP < 2.5s,FID < 100ms,CLS < 0.1 | Google Search Console | +| 移动端友好 | 响应式布局,字体 ≥ 16px | Google Mobile-Friendly Test | +| 图片优化 | WebP 格式,添加 `alt` 属性 | Squoosh | +| 页面加载速度 | 首屏 < 3s | PageSpeed Insights | +| 内部链接 | 各页面互相链接,建立层级 | 手动检查 | +| 404 处理 | 自定义 404 页面,含返回首页链接 | — | + +--- + +## 五、内容 SEO(博客策略) + +长期来看,内容是最可持续的 SEO 方式。 + +### 5.1 内容方向 + +``` +目标人群一:视障人士及其家属 +- 《盲人出行必备 5 款 App 推荐(2025)》 +- 《视障者如何独立使用手机?实用教程》 +- 《SeeForMe 使用教程:如何发起第一次视频求助》 + +目标人群二:志愿者 +- 《成为视障志愿者需要什么?》 +- 《一次 SeeForMe 志愿服务是什么体验?》 + +目标人群三:开发者 / 公益圈 +- 《开源公益 App SeeForMe 技术架构分享》 +- 《Expo + FastAPI 搭建实时视频公益服务》 +``` + +### 5.2 发布频率 + +早期:**每月 2 篇**,优先保证质量。 + +--- + +## 六、外链与品牌曝光 + +| 渠道 | 行动 | +|------|------| +| 少数派 / 即刻 | 写产品故事文章,附 App 下载链接 | +| 公益组织合作 | 联系中国盲人协会等挂友情链接 | +| GitHub README | 添加 App Store / Google Play 徽章和链接 | +| Product Hunt | 英文市场发布(发布当天冲榜) | +| V2EX / 掘金 | 技术开源故事,吸引开发者关注 | + +--- + +## 七、执行优先级 + +``` +第一步(立即): + ✅ 完善 App Store / Google Play 文案和截图 + ✅ 注册 Google Search Console,提交 sitemap + +第二步(2 周内): + ✅ 部署独立落地页,添加完整元数据和 JSON-LD + ✅ 配置 robots.txt 和 sitemap.xml + +第三步(1 个月内): + ✅ 发布第一批 SEO 博客文章(2-3 篇) + ✅ 在公益 / 无障碍社区建立外链 + +第四步(持续): + ✅ 每月追踪 Search Console 数据,优化表现差的页面 + ✅ 按关键词排名情况补充新内容 +``` + +--- + +## 八、监测工具 + +| 工具 | 用途 | 费用 | +|------|------|------| +| Google Search Console | 收录状态、点击量、关键词排名 | 免费 | +| Google Analytics 4 | 落地页流量与用户行为 | 免费 | +| PageSpeed Insights | Core Web Vitals 检测 | 免费 | +| Ahrefs / Semrush | 竞品分析、关键词研究 | 付费(选用) | +| App Annie / data.ai | ASO 竞品数据 | 免费基础版 | + +--- + +> **总结**:移动 App 的 SEO 核心是"双轮驱动"——应用商店内的 ASO 覆盖有安装意图的用户,独立 Web 落地页覆盖搜索引擎带来的泛需求用户。两者同步推进,才能最大化自然流量。