📖 Hướng Dẫn Sử Dụng NTCK Content Tools SEO

Hướng dẫn đầy đủ từ A–Z — từ cài đặt đến viết bài SEO tự động lên WordPress.

Kiến trúc hoạt động

Tool gồm 3 thành phần chính:

• Google Sheet — giao diện chính, nơi bạn nhập từ khóa và theo dõi tiến độ
• Google Apps Script (GAS) — engine xử lý AI + đăng bài chạy trên nền Google Cloud
• License Server — xác thực bản quyền, đảm bảo mỗi key chỉ dùng 1 người

🚀 Bắt Đầu Nhanh (5 bước)

1. 1
   Copy Google Sheet template về tài khoản của bạn

   Mở link template → File → Make a copy

2. 2
   Kích hoạt License Key

   Menu 📝 NTCK → License & API Key → Kích hoạt License mới

3. 3
   Nhập API Key (Gemini hoặc Yescale)

   Menu 📝 NTCK → License & API Key → Google API Key

4. 4
   Cấu hình WordPress trong sheet Setting

   Nhập URL website, tên đăng nhập WP, App Password

5. 5
   Nhập từ khóa → tick checkbox → chờ kết quả

   Điền từ khóa vào cột B → tick cột N (Viết Bài) → trong ~1 phút bài sẽ xuất hiện

📦 So Sánh Gói License

1️⃣ Copy Google Sheet Template

1. 1
   Mở link template

   👉 Nhấn vào đây để mở Google Sheet template

2. 2
   Tạo bản sao về tài khoản Google của bạn

   Menu File → Make a copy → đặt tên tùy ý → nhấn Make a copy

3. 3
   Cấp quyền cho Apps Script khi được yêu cầu

   Lần đầu mở bản copy, Google sẽ hỏi cấp quyền. Chọn Continue → Allow. Đây là Google Apps Script thuần túy, không phải extension bên thứ ba.

4. 4
   Menu NTCK xuất hiện trên thanh menu

   Sau khi cấp quyền, reload trang — menu 📝 NTCK sẽ hiện ở thanh menu phía trên.

2️⃣ Kích Hoạt License Key

Sau khi thanh toán, license key sẽ được gửi về email của bạn trong vòng vài phút.

1. 1
   Mở Google Sheet đã copy ở bước trước
2. 2
   Vào menu: 📝 NTCK → License & API Key → Kích hoạt License mới
3. 3
   Nhập License Key và email đã mua

   Key có dạng: NTCK-XXXX-XXXX-XXXX-XXXX

4. 4
   Nhấn Kích Hoạt — thông báo thành công xuất hiện

   Thông báo xanh với tên gói (Starter / Pro / Ultimate) là kích hoạt thành công.

3️⃣ Cài Đặt API Key

Tool dùng AI để viết bài. Bạn cần ít nhất 1 trong 2 key sau: Yescale (khuyến nghị) hoặc Google Gemini (miễn phí).

3.1 Google Gemini API Key (miễn phí — khuyến nghị cho người mới)

Google cung cấp quota miễn phí, đủ để viết 50–100 bài/tháng với Gemini Flash.

1. 1
   Mở Google AI Studio

   Truy cập: aistudio.google.com/app/apikey

2. 2
   Đăng nhập bằng tài khoản Google

   Dùng cùng tài khoản với Google Sheet là tốt nhất.

3. 3
   Nhấn nút "Create API key"

   Nếu lần đầu dùng, Google sẽ yêu cầu chọn hoặc tạo project — chọn "Create API key in new project" là đơn giản nhất.

4. 4
   Copy key vừa tạo

   Key có dạng: AIzaSy... (dài ~39 ký tự). Nhấn biểu tượng copy.

5. 5
   Nhập vào Google Sheet

   Menu 📝 NTCK → License & API Key → Google API Key → dán key → OK

6. 6
   Cấu hình nhà cung cấp AI trong Setting

   Trong sheet Setting, cột "Nhà cung cấp AI" → chọn GoogleCloud

3.2 Yescale API Key (nhanh hơn, ổn định hơn — khuyến nghị cho Pro/Ultimate)

Yescale là cổng AI proxy giá rẻ, hỗ trợ nhiều model (Gemini, Claude, GPT…) chỉ qua một key. Không có quota miễn phí — trả theo lượng dùng, chi phí thường chỉ vài trăm đồng mỗi bài.

1. 1
   Đăng ký tài khoản Yescale

   Truy cập yescale.bogia.app → đăng ký bằng email. Xác nhận email nếu được yêu cầu.

2. 2
   Nạp credit vào tài khoản

   Vào mục nạp tiền (Nạp credit / Top-up) trong trang quản lý tài khoản, nạp một khoản nhỏ để bắt đầu (50.000–100.000đ là đủ dùng thử nhiều bài).

3. 3
   Tạo API Key

   Tìm mục API Keys (hoặc Tokens) trong trang quản lý → tạo key mới → đặt tên gợi nhớ, ví dụ "NTCK".

4. 4
   Copy key ngay khi tạo

   Sao chép chuỗi key vừa tạo và lưu lại — một số trang chỉ hiện key đầy đủ đúng một lần.

5. 5
   Nhập key vào Google Sheet

   Menu 📝 NTCK → License & API Key → Yescale API Key → dán key → OK

6. 6
   Chọn nhà cung cấp AI là Yescale

   Trong sheet Setting, cột "Nhà cung cấp AI" → chọn Yescale.

3.3 Các API Key khác (tùy chọn)

4️⃣ Kết Nối WordPress

NTCK dùng WordPress Application Password để đăng bài — không cần cài plugin thêm, tính năng này có sẵn từ WordPress 5.6.

Lấy Application Password trên WordPress

1. 1
   Đăng nhập WP Admin

   Vào yoursite.com/wp-admin

2. 2
   Vào Users → Profile (hoặc Users → All Users → click tên tài khoản của bạn)
3. 3
   Cuộn xuống mục "Application Passwords"

   Mục này ở gần cuối trang profile.

4. 4
   Đặt tên cho app password (VD: "NTCK") → nhấn "Add New Application Password"
5. 5
   Copy mật khẩu vừa tạo ngay lập tức

   Password có dạng: xxxx xxxx xxxx xxxx xxxx xxxx (24 ký tự, cách nhau bằng dấu cách). Mật khẩu này chỉ hiển thị 1 lần — copy ngay!

Nhập thông tin vào sheet Setting

Mở sheet Setting → điền vào dòng 3 (hoặc dòng tương ứng với domain của bạn):

5️⃣ Cấu Hình Sheet Setting

Sheet Setting là nơi cấu hình mọi thứ: AI, phong cách viết, ảnh, SEO plugin...

Các trường quan trọng

✍️ Viết Bài Tự Động

Cách hoạt động

Mỗi bài viết qua 3 bước pipeline — bạn có thể chạy từng bước hoặc chạy thẳng toàn bộ:

Hướng dẫn từng bước

1. 1
   Chọn domain (nếu nhiều website)

   Mở Sidebar → chọn domain cần viết. Hoặc chuyển sang tab sheet tương ứng — tool tự động nhận domain.

2. 2
   Nhập từ khóa vào cột B

   Ví dụ: cà phê rang mộc là gì. Có thể thêm thông tin bổ trợ vào các cột C-J.

3. 3
   Click dòng từ khóa cần xử lý để chọn dòng đó
4. 4
   Tick checkbox ở cột N (Viết Bài) để chạy toàn bộ pipeline

   Tool sẽ tự viết outline → viết bài → điền meta SEO trong 1 lần.

5. 5
   Chờ ~1 phút — cột Q (Trạng Thái) sẽ cập nhật

   ✅ = thành công | ❌ = lỗi (xem cột R để biết lý do)

6. 6
   Tick cột P (Đăng Bài) để đăng lên WordPress

   Bài sẽ được tạo trên WP theo đúng cấu hình trong Setting (draft/publish).

Preview bài viết trước khi đăng

Menu 📝 NTCK → Preview Bài Viết — xem preview HTML của bài đang chọn, chỉnh sửa trực tiếp nếu cần.

🔑 Keyword Strategy — Nghiên Cứu Từ Khóa AI

Sheet Keyword Strategy giúp bạn nghiên cứu và mở rộng từ khóa bằng AI, sau đó đẩy sang Main sheet để viết bài.

Cách dùng

1. Mở Sidebar → tab Keyword Strategy
2. Nhập seed topic (ví dụ: cà phê rang mộc, cà phê sạch, café specialty)
3. Nhấn Nghiên Cứu Từ Khóa — AI sẽ tạo 50–80 từ khóa với cluster, intent, độ ưu tiên
4. Xem kết quả trong sheet Keyword Strategy
5. (Pro) Nhấn Enrich DataForSEO để lấy Volume / KD / CPC thực tế
6. Chọn từ khóa muốn viết → Đẩy sang Main

⚡ Batch Viết Hàng Loạt Pro

Viết nhiều bài cùng lúc mà không cần ngồi tick từng dòng.

1. 1
   Mở Sidebar → tab Batch

   Chọn: viết outline, viết bài, hay đăng bài — và khoảng dòng cần xử lý (VD: dòng 2–20)

2. 2
   Nhấn Chạy Batch

   Tool sẽ đẩy toàn bộ vào hàng đợi, chạy dần theo trigger 1 phút/lần.

3. 3
   Theo dõi tiến độ qua cột Q (Trạng Thái)

   Mỗi dòng tự cập nhật khi xong. Bạn có thể đóng trình duyệt, GAS chạy nền trên cloud.

🔍 Audit Content & Viết Lại Pro

Tính năng kiểm tra chất lượng bài cũ và tự động viết lại để cải thiện SEO score.

1. Vào sheet Audit Content
2. Nhập URL bài viết cần audit vào cột URL
3. Tick checkbox cột Audit — tool đọc nội dung → chấm điểm SEO → đề xuất cải thiện
4. Nếu điểm thấp, tick checkbox cột Viết Lại — AI viết lại toàn bộ bài
5. Preview bài mới: menu 📝 NTCK → Preview Bài Viết
6. Hài lòng → nhấn Đăng Lên WP trong preview dialog

Tự động phát hiện bài cần refresh

Menu 📝 NTCK → Kiểm tra bài cần refresh (>6 tháng) — tool quét toàn bộ sheet, đánh dấu các bài đã qua 6 tháng chưa cập nhật để bạn ưu tiên viết lại.

🔬 SEO Audit On-page Ultimate

Phân tích toàn diện 73 điểm on-page SEO cho bất kỳ URL nào — từ HTML parse đến Core Web Vitals, Google Search Console visibility và độ khó từ khóa. Kết quả trả về trong 1–3 phút, score 0–100, và danh sách 3 vấn đề ưu tiên cần fix ngay.

Hai sheet mới sau khi thiết lập

• SEO Audit — 1 dòng/URL, hiển thị tổng điểm + sub-score từng nhóm + top 3 fix
• SEO Audit Detail — 73 dòng/lần audit, chi tiết từng điểm Pass/Fail/Manual

Cách sử dụng

1. Menu 📝 NTCK → ⚙️ Quản trị → Thiết lập cấu trúc file — tạo 2 sheet mới nếu chưa có
2. Vào sheet SEO Audit, nhập URL vào cột B
3. Nhập từ khóa mục tiêu vào cột C (dùng để kiểm tra keyword presence trong title/H1/content)
4. Tick checkbox cột D (▶ AUDIT) — hệ thống tự động xếp hàng và chạy trong ~1 phút
5. Kết quả điền vào các cột E–N: tổng điểm, sub-score từng nhóm, top 3 vấn đề cần fix
6. Mở sheet SEO Audit Detail để xem 73 dòng chi tiết — màu xanh = Pass, đỏ = Fail, cam = Manual
7. Tick checkbox 18 điểm Manual (E-E-A-T / GEO / Intent / Topical) nếu điều kiện đã đạt → tổng điểm tự cập nhật

Phân nhóm 73 điểm

Thang điểm

• A (90–100) — Tốt, giữ nguyên và theo dõi định kỳ
• B (75–89) — Khá, cải thiện thêm 1–2 điểm để lên A
• C (60–74) — Trung bình, cần cải thiện trước khi scale traffic
• D (45–59) — Yếu, ưu tiên fix ngay nhóm điểm cao nhất
• F (<45) — Cần viết lại hoặc tối ưu toàn diện

API cần thiết

• PageSpeed API Key (tùy chọn) — miễn phí 25K req/ngày, không có key vẫn chạy nhưng có thể bị rate-limit. Thêm tại menu 🔑 License & API Key → PageSpeed API Key
• Google Search Console — reuse Service Account JSON đã cấu hình cho Indexing API. Nếu chưa có, 5 điểm GSC sẽ hiện "skip"
• DataForSEO — reuse credentials từ Keyword Strategy. Nếu chưa có, 5 điểm KW Difficulty hiện "skip"

Truy cập nhanh (menu)

• 📝 NTCK → 🔍 Mở Sheet SEO Audit — điều hướng đến sheet, con trỏ đặt ở dòng trống tiếp theo
• 📝 NTCK → 🔍 Audit SEO On-page (dòng hiện tại) — chạy audit cho dòng đang được chọn (không cần tick checkbox)

📈 CTR Optimizer Pro

Kết nối Google Search Console, phân tích các từ khóa có impression cao nhưng CTR thấp, và tự động viết lại Title + Meta Description để tăng clicks.

1. Menu 📝 NTCK → Quản trị → Thiết lập Google Search Console
2. Nhập Property URL của site trên GSC
3. Tool lấy dữ liệu CTR 90 ngày → phân tích cơ hội cải thiện
4. Tick dòng muốn tối ưu → AI viết lại title/meta mới
5. Đăng cập nhật lên WP

🚀 Google Indexing API Pro

Gửi URL bài mới đăng thẳng đến Google để được index nhanh hơn (thay vì chờ crawler tự tìm).

1. Tạo Google Service Account tại console.cloud.google.com
2. Bật API "Indexing API" → tạo service account → download file JSON
3. Thêm service account email vào Google Search Console với quyền Owner
4. Dán nội dung JSON vào cột Service Account Key trong Setting
5. Bật checkbox Gửi Google Indexing trong Setting
6. Từ đó, mỗi bài đăng lên WP sẽ tự động gửi ping đến Google

💰 Theo Dõi Chi Phí API

Tool tự động ghi lại chi phí API (token) cho mỗi bài viết.

• Bật: Tick checkbox Theo dõi chi phí API trong Setting
• Nhập tỷ lệ: Chi phí / 1K token (VD: 500 đồng) và Tỷ giá USD→VND
• Chi phí mỗi bài hiển thị ở cột Z (Chi Phí VND)
• Xem tổng hợp: menu 📝 NTCK → Hỗ trợ → Xem chi phí API

🌐 Quản Lý Nhiều Website Pro

Một file Google Sheet có thể quản lý nhiều website cùng lúc.

1. Thêm mỗi domain vào 1 dòng mới trong sheet Setting
2. Tạo 1 sheet mới đặt tên = domain (VD: cafenhan.com)
3. Tool tự nhận domain khi bạn chuyển sang tab sheet đó
4. Hoặc chọn domain thủ công trong Sidebar → dropdown Chọn Domain

📋 Tùy Chỉnh Prompt

Bạn có thể tùy chỉnh hoàn toàn cách AI viết bài qua sheet Prompts và Prompt Manager.

Prompt Manager

Menu 📝 NTCK → Quản lý Prompt — giao diện quản lý prompt trực quan, có thể:

• Xem/sửa prompt mặc định
• Tạo prompt tùy chỉnh cho từng domain hoặc loại bài
• Chạy thử pipeline với prompt tùy chỉnh ngay từ dialog

Sheet Prompts

Lưu trữ prompt theo cấu trúc: Domain | Tên Prompt | Nội dung Prompt. Có thể import/export dễ dàng.

🛠️ Xử Lý Lỗi Thường Gặp

Menu NTCK không xuất hiện

• Reload trang (F5)
• Kiểm tra đã cấp quyền Apps Script chưa: menu Extensions → Apps Script → xem có báo lỗi không
• Đảm bảo đang dùng bản copy của bạn, không phải file gốc template (bạn không có quyền chạy script trên file gốc)

Lỗi "Authorization required" khi lần đầu dùng

• Click Continue → chọn tài khoản Google → nhấn Allow
• Nếu thấy cảnh báo "App isn't verified": nhấn Advanced → Go to [tên file] (unsafe) → Allow
• Đây là script của bạn, không phải app bên ngoài — an toàn để cấp quyền

Bài không được viết sau khi tick checkbox

1. Kiểm tra cột Q (Trạng Thái) — nếu có ❌, đọc lý do ở cột R
2. Chạy Kiểm tra hệ thống: menu 📝 NTCK → Hỗ trợ → Kiểm tra hệ thống
3. Đảm bảo trigger đã cài: menu 📝 NTCK → Quản trị → Cài Header Button Trigger

Lỗi "API key không hợp lệ"

• Nhập lại API key: menu 📝 NTCK → License & API Key → [loại key]
• Gemini: đảm bảo key bắt đầu bằng AIzaSy...
• Kiểm tra quota tại: aistudio.google.com

Lỗi đăng bài lên WordPress (401 / 403)

• Kiểm tra lại Username WP (phải là username, không phải email)
• Kiểm tra Application Password: WP Admin → Users → Profile → Application Passwords
• Đảm bảo tài khoản WP có quyền Editor hoặc Administrator
• Một số hosting chặn XML-RPC / REST API — liên hệ hosting để mở

License báo "không hợp lệ" dù đã kích hoạt

• Kiểm tra kết nối internet
• Tool có grace period 7 ngày offline — nếu quá 7 ngày không online, cần kết nối lại để validate
• Liên hệ hỗ trợ nếu vẫn lỗi sau khi có internet

Lỗi do hết hạn ngạch (quota) Google trong ngày

Tool chạy trên nền Google Apps Script — Google giới hạn lượng tài nguyên mỗi tài khoản dùng trong 1 ngày. Khi vượt hạn ngạch, bạn có thể gặp lỗi kiểu "Service invoked too many times", "exceeded maximum execution time", hoặc bài dừng giữa chừng.

• Tài khoản Gmail thường (miễn phí) có hạn ngạch thấp hơn nhiều so với Google Workspace (email công ty trả phí). Tham khảo: thời lượng chạy trigger ~90 phút/ngày với Gmail thường so với ~6 giờ/ngày với Workspace; số lần gọi mạng (UrlFetch) ~20.000 so với ~100.000/ngày. Con số chính xác do Google quy định và có thể thay đổi.
• Hạn ngạch tự reset mỗi ngày (khoảng nửa đêm giờ Thái Bình Dương — tức trưa hôm sau giờ Việt Nam). Hết quota thì chờ sang ngày mới là chạy lại được.
• Nếu cần viết số lượng lớn mỗi ngày: nên dùng tài khoản Google Workspace để có hạn ngạch cao hơn nhiều, hoặc chia nhỏ công việc ra nhiều ngày.
• Tool có cơ chế checkpoint: nếu một bài bị dừng do hết giờ/quota, chỉ cần chạy lại — pipeline tiếp tục từ bước dở dang, không phải làm lại từ đầu.

Chạy System Check để kiểm tra tổng thể

Menu 📝 NTCK → Hỗ trợ → Kiểm tra hệ thống — hiển thị đầy đủ trạng thái: License, API Keys, Sheet, License Server.

❓ FAQ — Câu Hỏi Thường Gặp

Tôi có thể dùng trên bao nhiêu website?

Starter 1 website. Pro / Ultimate không giới hạn số domain trong 1 file Sheet.

Cần cài plugin gì trên WordPress không?

Không cần. Tool dùng WordPress REST API + Application Password có sẵn từ WP 5.6. Chỉ cần plugin SEO (RankMath hoặc Yoast) nếu muốn điền meta tự động.

Bài viết có bị trùng lặp với người khác không?

Không. AI tạo nội dung mới hoàn toàn dựa trên từ khóa và context bạn cung cấp. Mỗi người nhập context khác nhau → nội dung khác nhau.

Tôi có thể dùng nhiều tài khoản Google cùng 1 license không?

Không. Mỗi license key chỉ hoạt động trên 1 Google Sheet. Muốn dùng thêm Sheet mới, cần hủy kích hoạt ở Sheet cũ trước.

Nếu AI tạo nội dung không ổn, có thể chỉnh sửa không?

Hoàn toàn. Nội dung được lưu trong sheet, bạn chỉnh sửa trực tiếp trong ô. Dùng Preview Bài Viết để xem trước định dạng HTML. Tick đăng bài chỉ khi bạn đã hài lòng.

Bài viết tối thiểu bao nhiêu từ?

Tùy cấu hình cột Số Từ (cột H) trong Main sheet. Để trống = AI tự quyết định (~800–1500 từ). Nhập số cụ thể (VD: 2000) để yêu cầu độ dài tối thiểu.

Tool có hỗ trợ tiếng Anh không?

Có. Trong Setting, cột Ngôn ngữ → đổi từ Vietnamese sang English. Từ khóa nhập tiếng Anh → bài viết tiếng Anh.

Dùng model AI nào tốt nhất?

Với tiếng Việt: Gemini 2.5 Pro và Claude Sonnet cho chất lượng cao nhất. Gemini Flash nhanh và rẻ hơn, đủ tốt cho hầu hết nội dung. Dùng chế độ rotate để tool tự xoay vòng tránh rate limit.

📞 Liên Hệ & Hỗ Trợ