Skip to content

feat: word-to-color GEO + share card + S1 data baseline#3

Merged
JasonYeYuhe merged 6 commits into
mainfrom
feat/word-to-color-geo
Jun 1, 2026
Merged

feat: word-to-color GEO + share card + S1 data baseline#3
JasonYeYuhe merged 6 commits into
mainfrom
feat/word-to-color-geo

Conversation

@JasonYeYuhe
Copy link
Copy Markdown
Owner

背景

基于 Gemini 3.1 Pro + Codex 双 review 后重写的 V2 计划(验证+分发,见 docs/dev-plan-2026-05-31.md),以及对生产真实数据的挖掘(docs/baseline-metrics-2026-05-31.md)。

关键数据发现

  • word-to-color 是头号入口(直接 PV + GSC 非品牌词双料第一)
  • ChatGPT 导流(399/30d)≳ Google 自然搜索(202 clicks/90d)
  • SEO 卡在第 2 页(avg pos 13.2,CTR 0.8%)——已索引、未排名
  • 真实付费 ≈ 0(流量意图与变现对象错配)

改动(均低风险、已验证)

GEO(顺应 AI 引擎已是最大来源)

  • public/llms.txt — 引导 ChatGPT/Perplexity 引用关键工具/内容,带署名
  • guides 的 Article schema 加厚(mainEntityOfPage/image/inLanguage/articleSection/about/publisher.logo),364 篇受益
  • word-to-color FAQPage schema + 5 条可见 FAQ(单一数据源,满足 Google 合规)

功能(打磨头号入口)

  • word-to-color 可下载分享卡片(1080×1350 PNG),底部固定 colorarchive.org/word-to-color 引流署名;复用生产在用的 journal 导出技术,开放给所有用户

文档

  • V2 开发计划书 + 真实数据 baseline

验证

  • npm run typecheck 通过(干净 main 基础上)
  • ✅ 分享卡片在本地 Chrome 实测导出:布局、对比度自适应(深/浅块自动选黑白字)、署名均正确

说明

  • fix/security-hardening-2026-05-30 分支解耦——那批安全运维待办(token 轮换 / droplet 部署)不阻塞这些 SEO/功能改动
  • merge 到 main 会触发生产部署,/llms.txt 等届时生效

🤖 Generated with Claude Code

JasonYeYuhe and others added 4 commits June 1, 2026 16:27
V1 (self-built SQLite analytics layer + E2E test suite first) was
flagged by both reviewers as a wrong turn — engineer's comfort zone,
optimizing the mid/bottom funnel while avoiding acquisition. V2 pivots
to validation+distribution: 3rd-party analytics (not self-built), LS
Live + one real payment, ~10 user interviews to converge ICP, a new
distribution/GTM track, thin 4-6 case E2E, and an explicit S2 exit gate
if no PMF signal appears. Corrected: iOS uses server-side preference
sync, not CloudKit.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
S1 "open real signal" — queried production pageviews/events + GSC.
Findings in docs/baseline-metrics-2026-05-31.md:
- word-to-color is the #1 entry (direct PV + GSC non-brand queries)
- ChatGPT referrals (399/30d) now rival Google organic (202 clicks/90d)
- SEO sits on page 2 (avg pos 13.2, CTR 0.8%) — indexed, not ranked
- real Pro payments ~= 0 (intent/audience mismatch)

First no-regret GEO moves:
- public/llms.txt: guide AI engines to key tools/content with attribution
- guides Article schema: add mainEntityOfPage/image/inLanguage/
  articleSection/about/publisher.logo across all 364 guides

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
word-to-color is the #1 entry point (direct PV + GSC non-brand queries).
Add 5 visible FAQs (how it works / determinism / free / commercial use /
variants) from a shared data source (src/lib/word-color-faq.ts), plus
FAQPage structured data on the route — targets Google FAQ rich results
and AI-engine citation (GEO), the site's largest growing referral source.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
word-to-color is the #1 entry and already gets shared/indexed (GSC +
referrers). Add a 1080x1350 portrait share card downloadable as PNG, so
users get a visual, attributable artifact for Xiaohongshu/IG/X instead
of just a link. Every export carries colorarchive.org/word-to-color in
the footer — turns organic sharing into self-attributing traffic.

Reuses the production journal-export pattern (html-to-image toPng +
off-screen 1080 node, inline styles). Open to all users (no Pro gate) —
the attribution credit is the point.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Jun 1, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
color-archive Ready Ready Preview, Comment Jun 1, 2026 8:13am

Request Review

JasonYeYuhe and others added 2 commits June 1, 2026 17:05
ChatGPT is already the site's largest external referral source, but
Google-Extended and Applebot-Extended must be allowed *explicitly* for
content to be eligible for Gemini / Apple Intelligence answers — they
are not covered by the "*" rule for AI use. Add an explicit allow rule
for major AI/LLM crawlers (GPTBot, OAI-SearchBot, ChatGPT-User,
PerplexityBot, ClaudeBot, Google-Extended, Applebot-Extended, CCBot,
cohere-ai) with the same private-path restrictions as everyone else.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Targets the biggest blind spot flagged by both reviewers + baseline:
who is the word-to-color user, why they return, what they'd pay for.
Ready-to-run: recruiting channels, behavioral questions (with EN
versions for the mostly-English audience), analysis, and a tie-in to
the V2 S2 exit gate. Hands the validation tool to the user — they only
need to book ~10 conversations.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@JasonYeYuhe JasonYeYuhe merged commit 7e19f32 into main Jun 1, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant