DEV Community: Mạnh Digital

Viết lại tờ brief SEO: 9 ô cần điền trước khi gõ chữ đầu tiên

Mạnh Digital — Wed, 21 Oct 2026 08:59:05 +0000

Một kịch bản mình hay gặp (ví dụ minh họa, không phải một khách hàng cụ thể): chủ website nhắn cho writer "viết giúp anh bài 1.500 từ, keyword là X". Hai ngày sau bài về, câu chữ mượt, đúng chính tả. Đăng lên, ba tháng sau vẫn không ai tìm thấy.

Người viết không làm sai. Họ chỉ nhận một tờ brief gồm hai thứ: keyword và số từ. Còn lại họ phải tự đoán.

Dưới đây là cách mình viết lại tờ brief, theo kiểu nhật ký: mỗi lần bài hỏng, mình thêm một ô vào form.

9 ô cần điền trước khi viết

#	Ô cần điền	Câu hỏi nó trả lời
1	Keyword chính	Cụm từ người dùng thực sự gõ là gì?
2	Keyword phụ	Những biến thể nào cùng intent với nó?
3	Intent	Họ muốn học, so sánh hay mua?
4	Nhiệm vụ của người đọc	Đọc xong họ làm được việc gì?
5	Vai trò URL	Đây là pillar, guide hay template?
6	Câu trả lời bắt buộc	Câu hỏi nào bài phải trả lời ngay phần đầu?
7	Bằng chứng	Số liệu, ví dụ, nguồn nào chứng minh?
8	Internal link	Bài này nối với trang nào, và từ trang nào trỏ tới?
9	KPI sau đăng	Đo bằng gì: index, hiển thị, click, vị trí?

Ô số 5 là ô bị bỏ sót nhiều nhất. Hai bài cùng tranh một intent thì tự cạnh tranh với chính mình. Mỗi URL cần một nhiệm vụ riêng.

Checklist kỹ thuật trước khi bấm đăng

Trang trả về HTTP 200.
Có self-canonical, không bị noindex.
Nội dung chính nằm trong HTML ban đầu, không phụ thuộc hoàn toàn vào JavaScript chạy sau.
Schema (nếu có) khớp với nội dung hiển thị.
Title, H1, meta description khác nhau giữa các URL.

Một lưu ý quan trọng

Template chỉ là lan can chống bỏ sót, không phải công thức xếp hạng. Điền đủ 9 ô không đảm bảo lên top. Nó chỉ đảm bảo người viết không phải đoán, và bạn có chỗ để quay lại xem bài hỏng ở khâu nào.

Bản đầy đủ có ví dụ điền sẵn: mẫu bài viết chuẩn SEO trên ManhDigital.

Biến template bài viết chuẩn SEO thành YAML + script Python kiểm tra tự động

Mạnh Digital — Tue, 20 Oct 2026 17:13:51 +0000

Viết content SEO theo template thì dễ quên ô này, bỏ sót ô kia. Dân kỹ thuật có một cách quen thuộc để xử lý chuyện đó: biến template thành dữ liệu có cấu trúc, rồi viết một script nhỏ để kiểm tra. Bài này hướng dẫn từng bước làm việc đó với YAML và Python, khoảng 60 dòng code.

Lưu ý: script chỉ kiểm tra "đủ ô" và vài lỗi hình thức. Nó không chấm được nội dung có hữu ích hay không. Phần đó vẫn cần người biên tập.

Bước 1: Định nghĩa brief bằng YAML

Tạo file brief.yaml cho mỗi bài:

keyword: "mẫu bài viết chuẩn seo"
secondary: ["template bài viết seo"]
intent: informational        # informational | commercial | transactional | navigational
reader: "người viết content mới, đã biết SEO cơ bản"
task: "tự lập brief và dàn bài mà không bỏ sót onpage"
role: cluster                # pillar | cluster | landing | tool
must_answer:
  - "Mẫu gồm những phần nào?"
  - "Điền brief thế nào?"
  - "Kiểm tra gì trước khi đăng?"
title: "Mẫu bài viết chuẩn SEO: template có ví dụ"
meta: "Brief, dàn ý heading và checklist Onpage điền sẵn, kèm ví dụ thật."
internal_links:
  - "/blog/search-intent-la-gi"
sources:
  - "Google Search Central - helpful content"

Điểm quan trọng: task và must_answer là bắt buộc. Một brief chỉ có keyword và số từ là brief chưa xong.

Bước 2: Viết bản nháp bằng Markdown

Bản nháp draft.md dùng # cho H1, ## cho H2. Mỗi H2 nên ứng với một câu hỏi trong must_answer.

Bước 3: Viết script kiểm tra

# check_brief.py
import re, sys, yaml

REQUIRED = ["keyword", "intent", "reader", "task", "role",
            "must_answer", "title", "meta"]

def check(brief_path, draft_path):
    b = yaml.safe_load(open(brief_path, encoding="utf-8"))
    md = open(draft_path, encoding="utf-8").read()
    issues = []

    # 1. Brief đủ ô
    for k in REQUIRED:
        if not b.get(k):
            issues.append(f"brief thiếu: {k}")

    # 2. Độ dài title/meta theo quy ước biên tập (không phải quy định của Google)
    if len(b.get("title", "")) > 60:
        issues.append("title > 60 ký tự")
    if len(b.get("meta", "")) > 160:
        issues.append("meta > 160 ký tự")

    # 3. Đúng một H1
    h1 = re.findall(r"^# (.+)$", md, re.M)
    if len(h1) != 1:
        issues.append(f"cần đúng 1 H1, đang có {len(h1)}")

    # 4. Keyword bị nhồi vào heading?
    h2 = re.findall(r"^## (.+)$", md, re.M)
    kw = b["keyword"].lower()
    stuffed = [h for h in h2 if kw in h.lower()]
    if h2 and len(stuffed) / len(h2) > 0.5:
        issues.append("hơn nửa số H2 lặp keyword chính")

    # 5. Mỗi câu hỏi bắt buộc có H2 tương ứng (so khớp thô theo từ)
    for q in b.get("must_answer", []):
        words = {w for w in re.findall(r"\w+", q.lower()) if len(w) > 3}
        if not any(words & set(re.findall(r"\w+", h.lower())) for h in h2):
            issues.append(f"chưa thấy H2 trả lời: {q}")

    # 6. Số liệu không có nguồn (heuristic: có % mà không có link)
    for line in md.splitlines():
        if "%" in line and "http" not in line:
            issues.append(f"số liệu chưa dẫn nguồn: {line[:60]}")

    return issues

if __name__ == "__main__":
    problems = check(sys.argv[1], sys.argv[2])
    print("\n".join(problems) or "OK: không phát hiện lỗi hình thức")
    sys.exit(1 if problems else 0)

Chạy thử:

pip install pyyaml
python check_brief.py brief.yaml draft.md

Bước 4: Đưa vào quy trình

Vài cách dùng thực tế:

Pre-commit hook: nếu nội dung nằm trong repo (Hugo, Astro, Next.js), chặn commit khi script trả mã lỗi.
CI: chạy trong GitHub Actions cho mỗi pull request chứa file .md mới, để reviewer thấy danh sách lỗi trước khi đọc.
Biên tập thủ công: ngay cả khi không có repo, chạy script trên bản export Markdown từ Google Docs hoặc Notion cũng đủ bắt được lỗi quên ô.

Bước 5: Biết giới hạn của script

Script này không biết:

Bài có thật sự trả lời đúng ý định tìm kiếm không.
Ví dụ và số liệu có chính xác không (nó chỉ phát hiện thiếu link nguồn).
Mở bài có đi thẳng vào vấn đề không.

Hướng dẫn về nội dung hữu ích của Google Search Central cũng không đặt ra số từ hay mật độ từ khóa cố định. Vì vậy hãy coi script như lan can chống bỏ sót, không phải công thức xếp hạng.

Lấy phần template ở đâu?

Các ô trong brief.yaml ở trên được rút gọn từ bộ template bài viết chuẩn SEO của Mạnh Digital, trong đó có bảng giải thích từng ô brief, khung heading và checklist Onpage đầy đủ. Bạn có thể map thêm các mục checklist thành rule mới cho script, ví dụ kiểm tra alt ảnh hoặc canonical.

Nếu bạn đã tự động hóa phần kiểm tra content theo cách khác, chia sẻ ở phần bình luận nhé.

Checklist kỹ thuật để website vừa lên Google vừa được AI trích dẫn

Mạnh Digital — Tue, 20 Oct 2026 08:15:33 +0000

Bài này dành cho dev và người tự quản website. Mình tổng hợp lại cách Mạnh Digital phân biệt hai lớp tối ưu: SEO website truyền thống và SEO AI (GEO/AEO). Không có trick, chỉ là những tín hiệu mà Google và các công cụ AI dùng để hiểu một trang.

Hai hệ thống, một nền móng

Tiêu chí	SEO website	SEO AI
Mục tiêu	Lên top khi khách tìm trên Google	Được nhắc tên, trích dẫn trong câu trả lời của AI
Nơi hiển thị	Google Search, Google Maps	ChatGPT, Gemini, Perplexity, Copilot, Google AI Overviews
Tín hiệu chính	Kỹ thuật, độ liên quan, backlink, trải nghiệm trang	Thông tin thương hiệu nhất quán, câu trả lời rõ ràng, nguồn bên ngoài nhắc tới

Chung một nền: trang được Google index tốt, và nội dung trả lời đúng câu hỏi người dùng. Nếu lớp dưới hỏng thì lớp trên cũng không đứng được.

Lớp 1: indexing và kỹ thuật

[ ] Trang quan trọng nằm trong sitemap, không bị noindex nhầm.
[ ] URL cũ đã 301 thì gỡ khỏi sitemap, sửa link nội bộ trỏ thẳng về URL mới.
[ ] Mỗi trang có một title riêng, không bị hard-code trong template khiến CMS không đổi được.
[ ] Tốc độ tải ổn trên mobile. Gói Growth của Mạnh Digital có hạng mục riêng cho tốc độ.
[ ] Kiểm tra trạng thái index định kỳ trong Search Console.

Lớp 2: nội dung trả lời thẳng

AI thích đoạn văn trả lời ngay câu hỏi trong 1–3 câu đầu, sau đó mới giải thích. Gợi ý cấu trúc:

H2: <câu hỏi thật của khách>
Đoạn 1: câu trả lời ngắn, có số liệu nếu có
Đoạn 2+: giải thích, ví dụ, ngoại lệ

Trang chủ manhdigital.com làm điều này ở phần FAQ: "Có cam kết chắc chắn được AI nhắc tên không?" và câu đầu là "Không." Rõ ràng, dễ trích.

Lớp 3: thực thể thương hiệu

[ ] Tên, địa chỉ, số điện thoại giống hệt nhau trên website, Google Business Profile và mạng xã hội.
[ ] Có trang hồ sơ người phụ trách (author/founder) với kinh nghiệm thật.
[ ] Có nguồn bên ngoài nhắc tới thương hiệu: báo, diễn đàn, hồ sơ doanh nghiệp.

Ví dụ thông tin nhất quán: Mạnh Digital, Tòa AZ Sky, Định Công, Hoàng Mai, điện thoại 0396 200 150.

Lớp 4: đo lường

Không đo thì không biết có tác dụng không. Search Console cho số lượt nhấp, hiển thị, vị trí; GA4 cho hành vi và chuyển đổi. Case Kho Tài Khoản trên trang chủ dùng đúng nguồn này: khoảng 193 nghìn lượt nhấp và 1,4 triệu lượt hiển thị trong 12 tháng theo ảnh GSC chụp 05/10/2026.

Lưu ý: không có cách nào đo chính xác "AI nhắc tên bao nhiêu lần" qua API chính thức. Gói Strategy của Mạnh Digital có hạng mục theo dõi AI nhắc tên, nhưng chính họ cũng nói không ai kiểm soát được câu trả lời của AI.

Timeline thực tế

Tuần 1–4: sửa kỹ thuật, trang dịch vụ, thông tin thương hiệu.
Sau đó: thứ hạng và khả năng được AI nhắc tên thay đổi chậm hơn, tùy ngành và độ cạnh tranh.

Khi nào nên nhờ người ngoài?

Nếu bạn là dev, lớp 1 bạn tự làm được. Lớp 2 và 3 tốn thời gian nghiên cứu từ khóa và viết. Bảng giá tham khảo của dịch vụ SEO tổng thể bên đó: Starter từ 9 triệu/tháng (5–10 từ khóa, 2–4 bài/tháng), Growth từ 15 triệu (15–25 từ khóa, 4–8 bài), Strategy từ 25 triệu (30–50 từ khóa, 8–12 bài). Chưa gồm VAT.

Happy optimizing. Nếu có checklist hay hơn, comment bên dưới nhé.

Debug lỗi không index như debug code: đọc log Search Console trước

Mạnh Digital — Tue, 20 Oct 2026 01:50:47 +0000

Khi production báo lỗi, không ai sửa bừa. Mình mở log, tìm stack trace, khoanh vùng module rồi mới viết patch. Thế nhưng với SEO, rất nhiều developer lại làm ngược: trang không lên Google là lập tức bấm "Request Indexing" năm bảy lần, như bấm F5 khi API trả về 500. Bài này là cách mình áp tư duy debug vào bài toán index, dựa trên hướng dẫn Index là gì trong SEO của team Mạnh Digital.

Định nghĩa vấn đề cho đúng

Trong ngữ cảnh SEO, index nghĩa là Google đã đọc trang, hiểu nội dung và lưu nó vào chỉ mục — cái database mà Google query mỗi khi người dùng tìm kiếm. Không có bản ghi trong database thì không có kết quả trả về, đơn giản vậy thôi. Nhưng có bản ghi cũng không có nghĩa là bạn ở top; đó mới là điều kiện cần.

Một điểm dev hay giả định sai: Google không có SLA nào về việc index toàn bộ site. Tài liệu chính thức nói thẳng rằng bạn không nên kỳ vọng mọi URL đều được lập chỉ mục. Vậy "bug" ở đây không phải là "có URL chưa được index", mà là "URL quan trọng chưa được index".

Hai stage: fetch và store

Hãy hình dung pipeline gồm hai bước. Bước một là crawl: Googlebot gửi request, tải HTML về. Bước hai là index: hệ thống quyết định có ghi trang đó vào chỉ mục hay không. Hai bước chạy nối tiếp nhưng độc lập — một URL có thể được fetch hàng chục lần mà vẫn bị từ chối ghi.

Vì vậy Search Console có hai trạng thái nghe rất giống nhau:

Đã phát hiện thấy – hiện chưa được lập chỉ mục: URL đã nằm trong hàng đợi nhưng chưa được fetch. Lỗi nằm ở stage một.
Đã thu thập dữ liệu – hiện chưa được lập chỉ mục: fetch xong rồi, nhưng stage hai trả về "chưa lưu". Lỗi nằm ở stage hai.

Nhầm hai cái này giống như debug frontend trong khi bug nằm ở backend.

Đọc log: công cụ Kiểm tra URL

Công cụ Kiểm tra URL trong Search Console là thứ gần với log nhất. Paste URL vào thanh trên cùng, kết quả "URL nằm trên Google" nghĩa là pass. Nếu là "URL không nằm trên Google", mở phần Lập chỉ mục trang để thấy reason code và thời điểm crawl gần nhất.

Nút "Kiểm tra URL đang hoạt động" thì giống chạy test trên bản build mới: nó cho biết phiên bản hiện tại có index được không, rất tiện khi bạn vừa deploy bản gỡ thẻ noindex. Lưu ý công cụ này có rate limit theo ngày cho mỗi property, nên đừng viết script dò từng URL.

Còn lệnh site: trên Google? Coi nó như console.log tạm bợ: nhanh, nhưng không đáng tin để kết luận, vì Google xác nhận kết quả không phải lúc nào cũng đầy đủ. Lệnh cache: thì đã bị gỡ từ 2024, đừng copy từ tutorial cũ nữa.

Những "reason code" thường gặp

Phần lớn URL trong nhóm không được lập chỉ mục là hành vi đúng, không phải bug. Một vài mã và cách xử lý:

URL có đánh dấu noindex — chỉ sửa nếu bạn gắn nhầm, ví dụ template staging lọt lên production.
Bị chặn bởi robots.txt — kiểm tra lại rule Disallow. Lưu ý: nếu chặn crawl, Google không đọc được thẻ noindex bên trong trang.
Trang thay thế có thẻ chính tắc thích hợp — expected behavior, bỏ qua.
Google chọn canonical khác với bạn — hai trang quá giống nhau; làm rõ trang chính, gộp hoặc tách nội dung.
Trang có lệnh chuyển hướng — dọn URL cũ khỏi sitemap và link nội bộ.
404 / soft 404 — khôi phục, redirect sang trang tương đương, hoặc để 404 nếu trang thật sự đã chết.

Khi không có error để chỉ tay

Case khó nhất là "đã thu thập dữ liệu" vì không có lỗi kỹ thuật. Thường root cause là một trong ba: nội dung trùng ý với trang khác trên chính site, trang gần như không có internal link trỏ tới, hoặc nội dung không khác gì hàng chục bài cùng chủ đề. Fix là refactor nội dung, không phải retry.

Với "đã phát hiện thấy" trên site nhỏ, nguyên nhân phổ biến là trang chỉ có trong sitemap.xml mà không có link nội bộ nào. Crawl budget hiếm khi là vấn đề — Google nói chủ đề này dành cho site khoảng một triệu trang hoặc khoảng mười nghìn trang thay đổi mỗi ngày.

Quy trình fix gợi ý

Inspect URL, ghi lại reason code.
Loại trừ blocker kỹ thuật: meta robots, robots.txt, canonical, redirect.
Thêm internal link từ những trang đã được index.
Cải thiện hoặc gộp nội dung trùng.
Kiểm tra sitemap, rồi request indexing đúng một lần.

Mình khuyên thêm bước kiểm tra meta robots và canonical vào checklist CI trước khi deploy. Nếu team bạn không có người chuyên technical SEO, có thể tham khảo dịch vụ SEO tại Hà Nội của Mạnh Digital — bài gốc của họ có bảng tra đầy đủ từng trạng thái.