Research và audit search với ak:seo

Dùng ak:seo cho audit SEO và GEO, keyword research và pSEO artifact trong khi tách provider query, OAuth, bulk generation và live search change.

Dùng ak:seo để audit page hoặc domain, kiểm tra GEO và AI discoverability, research và cluster keyword, hoặc thiết kế programmatic SEO template. Skill còn đóng gói script cho Search Console, Core Web Vitals, sitemap, schema và bulk page generation. Các script đó có tác động khác nhau lên network, credential, file và account; chúng không phải một workflow tự động duy nhất.

Chọn ak:seo cho evidence và implementation artifact

Dùng ak:seo khi

Bạn cần technical hoặc on-page audit cho public URL hay local content.
Bạn cần keyword idea, intent cluster, difficulty data hoặc competitor gap với source và freshness được ghi lại.
Bạn cần pSEO template, data schema, internal-linking plan và sample page.
Bạn cần sitemap hoặc JSON-LD artifact đã review trước implementation.
Bạn cần contract hoặc audit GEO và AI discoverability: robots.txt, sitemap.xml, llms.txt, llms-full.txt, biến thể .md của từng page, social metadata cùng card, và page action Copy, Share hoặc Open in AI.

Chọn workflow khác khi

Bạn cần content strategy rộng hơn mà không cần search evidence. Dùng ak:content-marketing.
Bạn cần final copy từ search brief đã duyệt. Dùng ak:write sau khi keyword và claim input được chấp nhận.
Bạn cần triển khai các surface GEO đó trong một framework. Việc triển khai thuộc về Skill của framework đó; với Next.js, dùng reference SEO và GEO của ak:web-frameworks trong Engineer Kit khi Kit đó đã được cài.
Bạn muốn bảo đảm ranking, traffic, rich result, indexing hoặc revenue. Không Skill hay provider output nào có thể thiết lập các outcome đó.

Chuẩn bị data, access và mutation boundary

Xác nhận Marketing Kit đã được cài cho đúng runtime và scope. Cung cấp target URL, domain, topic, country hoặc market, audience, business relevance, analytics hiện tại, competitor set và output boundary. Xác định dữ liệu nào có thể được gửi tới external service.

Keyword và audit data dựa trên ReviewWeb cần REVIEWWEB_API_KEY. Core Web Vitals request dùng Google PageSpeed Insights và có thể dùng PAGESPEED_API_KEY. Google Search Console cần property đã verify, Google Cloud OAuth client, Search Console API, googleapis và .claude/secrets/google_client_secret.json hoặc user-level secret path tương ứng. OAuth token được lưu cục bộ; hãy bảo vệ như credential.

Runtime	Cách gọi	Ranh giới khả dụng
Claude Code	`/ak:seo ...`	Phân phối native là mặc định; network và account operation vẫn cần access cùng approval rõ ràng.
Cursor	`/ak:seo ...`	Skill được projection sang Cursor và cách gọi bằng slash đã được người dùng xác minh; provider tooling vẫn có thể khác.
Codex	`$ak:seo ...`	Skill dùng native discovery của Codex; capability web, shell, credential và provider có trong session quyết định từng stage.

Chạy SEO task được định tuyến

/ak:seo audit https://example.com/pricing "Dùng public page evidence, công bố mọi provider request, chỉ ghi report và không đổi site hoặc Search Console"

/ak:seo keywords "privacy-first analytics" "Cluster theo intent cho thị trường US, phân biệt API data đo được với estimate và dẫn source date"

$ak:seo pseo comparison "Thiết kế một template, data schema và ba sample page từ approved dataset được cung cấp. Không publish hoặc bulk-generate production page"

Argument hint canonical liệt kê [audit|geo|keywords|pseo|optimize|schema] [target]. Trong bản này, chỉ audit, geo, keywords và pseo có routed reference workflow, và một lần audit toàn site cũng chạy checklist geo. Hãy xem optimize và schema là direct route chưa được chứng minh; dùng yêu cầu có scope rõ ràng hoặc bundled schema tool sau khi kiểm tra tác động.

Audit AI discoverability với geo

Route geo xem search crawler, AI answer engine và người dán page vào chat assistant là một contract chung. Route chỉ kiểm tra những gì framework và hosting của site có thể phục vụ, và báo các surface còn thiếu là khoảng trống.

Surface	Audit kỳ vọng gì
`robots.txt`	Cho phép public page, chặn private path cùng search-result path, có dòng `Sitemap:` tuyệt đối và AI crawler policy do chủ site chọn rõ ràng.
`sitemap.xml`	Chỉ canonical URL có thể index, `lastmod` thật, `<loc>` được XML-escape, không có biến thể `.md`.
`llms.txt` và `llms-full.txt`	Định dạng llmstxt.org với `## Optional` ở cuối, link tới biến thể `.md` của từng page, và full file được tạo từ cùng source, không có private content.
`<page>.md`	Bản Markdown song song tại URL của page cộng `.md` (`index.html.md` với URL kết thúc bằng `/`), phục vụ dạng `text/markdown; charset=utf-8`, được link từ HTML head bằng `rel=alternate` và gửi `X-Robots-Tag: noindex`.
Metadata và social card	`rel=canonical`, JSON-LD hợp lệ khớp nội dung hiển thị, Open Graph cùng Twitter tag đầy đủ và social image riêng cho từng page ở 1200×630.
Page action	Các control Copy as Markdown, Copy URL, Open in ChatGPT hoặc Claude và Share hoạt động không cần đăng nhập và xuống cấp nhẹ nhàng khi thiếu API.

Chặn AI crawler không bao giờ là mặc định. Robots reference tách agent cho training, search và user-initiated fetch theo từng operator, lưu ý các tên đã ngừng dùng như anthropic-ai và Claude-Web, và yêu cầu xác nhận tên agent hiện tại với từng operator trước khi áp dụng policy. Audit báo từng mục là pass, fail hoặc not applicable kèm URL và response quan sát được.

Hiểu các giai đoạn

Xác nhận câu hỏi và data source. Xác định URL, topic, market, timeframe, evidence source và task là analysis hay mutation.
Thu thập evidence. Đọc local content hoặc fetch public page. Khi được duyệt, query ReviewWeb, PageSpeed Insights hoặc Search Console và ghi source.
Phân tích evidence. Audit technical và on-page element, phân loại intent cùng cluster, hoặc thiết kế kiến trúc data và template pSEO.
Tạo artifact. Tạo report, template, schema, sitemap, sample page hoặc implementation recommendation trong output boundary đã duyệt.
Validate cục bộ. Kiểm tra JSON-LD structure, sitemap content, template escaping, duplicate, claim, canonical intent và sample quality. Sitemap generator được bundle XML-escape từng URL và bỏ lastmod cho page không có ngày được cung cấp thay vì gán ngày hôm nay.
Review trước live action. Con người duyệt code change, bulk file, deployment, indexing control, sitemap submission hoặc deletion, outreach và mọi provider account mutation.

Tách query, file generation và account change

SEO analysis không cấp quyền live search change

Search Console query action có thể đọc private property data, còn các bundled flag riêng có thể submit hoặc delete sitemap. pSEO generator ghi nhiều HTML file và checkpoint. Sitemap cùng schema generator ghi output file. Phê duyệt rõ từng tác động; không suy ra quyền đó từ yêu cầu audit.

Review URL và customer data trước khi gửi tới ReviewWeb, Google, browser tool hoặc provider khác. Không đặt API key hay OAuth token trong argument, report hoặc commit. Link building và outreach vẫn là công việc cần con người duyệt riêng; tránh spam, placement lừa dối và quan hệ bị bịa.

Xác minh output và bằng chứng

Top-level Skill summary nêu report path dưới assets/reports/seo/, trong khi routed reference audit và keywords nêu assets/seo/audits/ và assets/seo/keywords/. Xác nhận path thực do lần chạy trả về trước khi tạo automation. Route pSEO ghi dưới assets/attraction/pseo-templates/; schema output được mô tả dưới assets/seo/schemas/.

Yêu cầu report xác định URL, query date, country hoặc market, provider và endpoint, field đo được so với estimate, dữ liệu thiếu, issue theo priority và next check được khuyến nghị. Với generated file, kiểm tra file list và diff chính xác. Local schema validation pass không bảo đảm search engine rich result, còn sitemap được submit không bảo đảm indexing.

Xử lý sự cố và biết giới hạn

Triệu chứng	Bước tiếp theo an toàn
ReviewWeb data không khả dụng	Tiếp tục bằng public hoặc local evidence được gắn nhãn rõ, hoặc cấu hình `REVIEWWEB_API_KEY`; không bịa volume, CPC, difficulty, traffic hay backlink.
Search Console authentication thất bại	Xác minh property, OAuth client, scope, secret path, local callback, dependency và token status mà không lộ credential.
Report path khác overview	Dùng path thực được trả về và ghi nhận source-path inconsistency; không âm thầm move hoặc overwrite file.
`optimize` hoặc `schema` không route	Dùng `audit`, `geo`, `keywords` hoặc `pseo`, hoặc yêu cầu schema artifact có scope rõ rồi kiểm tra bundled generator trực tiếp.
Bulk pSEO output chất lượng thấp hoặc trùng lặp	Dừng generation, kiểm tra template cùng dataset, không tự động xóa gì và yêu cầu unique value cùng human sampling trước publication.
Runtime discovery thất bại	Làm theo Runtime không tìm thấy Skill hoặc Agent.

Search data, provider API, platform rule và ranking system thay đổi. Skill không thể bảo đảm data completeness, ranking, indexing, traffic, rich result, conversion hay revenue. Tiếp tục với tổng quan Marketing Kit và giữ mọi live mutation ở bước duyệt riêng.

Research và audit search với ak:seo

On this page