Rank Math Info – Plugin WordPress giúp expose dữ liệu (by Webo)

Trong quá trình xây dựng website WordPress hiện đại, đặc biệt là các hệ thống headless CMS, AI content, automation, hay đồng bộ dữ liệu với bên thứ ba, REST API đóng vai trò cực kỳ quan trọng. Tuy nhiên, một vấn đề phổ biến là: Dữ liệu SEO của Rank Math không được expose đầy đủ qua REST API mặc định của WordPress.

Đây chính là lý do Webo phát triển plugin Rank Math Info – một plugin WordPress nhẹ, đơn giản và tập trung đúng mục tiêu:

Thêm thông tin Rank Math SEO vào REST API cho post type mặc định (post).

Rank Math Info là gì?

Rank Math Info là một plugin WordPress do Webo phát triển, được thiết kế nhằm giải quyết một hạn chế phổ biến của WordPress khi sử dụng plugin SEO Rank Math: dữ liệu SEO không được expose đầy đủ qua WordPress REST API mặc định.

Plugin này đóng vai trò như một cầu nối dữ liệu, giúp đưa các thông tin SEO quan trọng của Rank Math (như SEO Title, Meta Description, Focus Keyword…) ra ngoài REST API để các hệ thống khác có thể đọc và cập nhật một cách chủ động.

Điểm đặc biệt của Rank Math Info là triết lý tối giản và an toàn:

• Plugin không can thiệp sâu vào logic hoạt động của Rank Math
• Không sử dụng API nội bộ hay class riêng của Rank Math, tránh rủi ro xung đột hoặc thay đổi khi Rank Math update
• Chỉ làm việc trực tiếp với postmeta – nơi Rank Math lưu trữ dữ liệu SEO gốc

Vì sao cần expose Rank Math SEO ra REST API?

Trong mô hình WordPress truyền thống, SEO thường được quản lý hoàn toàn trong admin dashboard thông qua các plugin như Rank Math. Cách làm này phù hợp với website nhỏ hoặc quy trình thủ công. Tuy nhiên, với các hệ thống hiện đại, chỉ quản lý SEO trong admin WordPress là chưa đủ.

Ngày càng nhiều website và sản phẩm số cần truy cập, đồng bộ và chỉnh sửa dữ liệu SEO một cách linh hoạt thông qua API:

1. Website Headless WordPress. Expose Rank Math SEO ra REST API là yêu cầu bắt buộc với Headless WordPress.
2. Hệ thống AI viết & tối ưu nội dung. REST API giúp AI SEO hoạt động hoàn toàn tự động.
3. Tool đồng bộ bài viết từ CMS khác
4. Automation SEO & Content Workflow. REST API là nền tảng để xây dựng SEO automation workflow.
5. Dashboard quản lý nội dung bên ngoài WordPress.

Tất cả các mô hình trên đều có chung một nhu cầu:

Đọc và cập nhật SEO title, meta description, focus keyword thông qua REST API.

Và đó chính là khoảng trống mà WordPress + Rank Math chưa giải quyết tốt theo mặc định.

Rank Math Info ra đời để giải quyết chính xác nhu cầu đó: Expose dữ liệu Rank Math SEO ra REST API một cách nhẹ – an toàn – dễ kiểm soát, giúp SEO sẵn sàng cho các hệ thống hiện đại, headless và automation.

Tính năng chính của Rank Math Info

Rank Math Info được Webo phát triển với mục tiêu rõ ràng: expose dữ liệu SEO của Rank Math ra REST API một cách an toàn, gọn nhẹ và đúng nhu cầu thực tế. Thay vì cố gắng làm quá nhiều thứ, plugin tập trung vào những tính năng cốt lõi nhất.

1. Thêm field Rank Math vào REST API

Rank Math Info sử dụng hàm chuẩn của WordPress là register_rest_field() để bổ sung các field SEO của Rank Math trực tiếp vào REST API.

Các field này sẽ xuất hiện ngay trong endpoint mặc định:

 GET /wp-json/wp/v2/posts/{id}

Nhờ đó:

• Dữ liệu SEO không còn “ẩn” trong admin WordPress
• Frontend, hệ thống headless hoặc tool bên ngoài có thể truy cập trực tiếp
• Không cần tạo endpoint riêng hay custom API phức tạp

Đây là cách làm đúng chuẩn WordPress, đảm bảo tính tương thích và ổn định lâu dài.

2. Hỗ trợ đầy đủ GET & UPDATE dữ liệu SEO

Không chỉ dừng lại ở việc đọc dữ liệu, Rank Math Info còn cho phép cập nhật ngược lại SEO thông qua REST API.

• GET
  Lấy các thông tin SEO của bài viết như:
  • SEO Title
  • Meta Description
  • Focus Keyword
• POST / PUT
  Cho phép update trực tiếp các field SEO này từ:
  • AI content system
  • Tool automation
  • Dashboard quản lý bên ngoài WordPress

Việc update chỉ được phép khi request có quyền phù hợp (edit_posts hoặc cao hơn), đảm bảo an toàn dữ liệu SEO.

3. Chỉ áp dụng cho post type post

Rank Math Info được thiết kế chỉ áp dụng cho post type mặc định post, mang lại nhiều lợi ích:

• Không ảnh hưởng đến các Custom Post Type (CPT) khác
• Tránh rủi ro lan rộng trong hệ thống lớn
• Phù hợp với nhu cầu phổ biến nhất của blog, content site và SEO site

4. Nhẹ – Không phụ thuộc Rank Math API nội bộ. Một điểm khác biệt quan trọng của Rank Math Info là không phụ thuộc vào API hay class nội bộ của Rank Math.

Các field Rank Math được hỗ trợ

Rank Math Info tập trung expose những field SEO quan trọng nhất của Rank Math ra REST API, phục vụ trực tiếp cho các nhu cầu đọc – cập nhật SEO trong hệ thống hiện đại.

Rank Math Meta Key	REST API Field	Ý nghĩa
rank_math_focus_keyword	rankmath_keyword	Từ khóa chính của bài viết, dùng để định hướng nội dung và đánh giá mức độ tối ưu SEO
rank_math_description	rankmath_description	Meta Description – đoạn mô tả hiển thị trên kết quả tìm kiếm
rank_math_title	rankmath_title	SEO Title – tiêu đề hiển thị trên Google và các công cụ tìm kiếm

Cách Rank Math Info hoạt động

Rank Math Info được xây dựng theo triết lý đơn giản – đúng chuẩn WordPress – không can thiệp sâu. Plugin không thay đổi cách Rank Math vận hành SEO, mà chỉ đảm nhiệm vai trò kết nối dữ liệu SEO với REST API.

Cơ chế hoạt động kỹ thuật

Về mặt kỹ thuật, plugin sử dụng hàm chuẩn của WordPress là register_rest_field() để bổ sung các field SEO vào REST API của post type post.

Cụ thể, Rank Math Info thực hiện:

• Lấy dữ liệu trực tiếp từ postmeta. Các thông tin SEO như SEO title, meta description, focus keyword vốn được Rank Math lưu trong postmeta. Plugin chỉ đọc đúng những key này, không xử lý lại logic SEO.
• Expose dữ liệu ra REST API
• Cho phép update dữ liệu với context edit
  Khi request có quyền chỉnh sửa bài viết, plugin cho phép:
  • Ghi ngược dữ liệu SEO vào postmeta
  • Đồng bộ SEO từ bên ngoài về WordPress

Toàn bộ quá trình đều tuân thủ chuẩn REST API của WordPress, đảm bảo an toàn và tương thích lâu dài.

Không ảnh hưởng đến Rank Math gốc

Một điểm quan trọng trong thiết kế của Rank Math Info là không can thiệp vào logic SEO của Rank Math:

• Không override dữ liệu
• Không thay đổi cách Rank Math tính điểm SEO
• Không ảnh hưởng đến schema, sitemap hay các tính năng khác

Rank Math vẫn hoạt động hoàn toàn độc lập, đúng như khi plugin không tồn tại.

Không thay đổi UI trong admin WordPress

Rank Math Info:

• Không thêm menu mới
• Không chỉnh sửa màn hình edit post
• Không tạo setting phức tạp

Mọi thao tác SEO trong admin WordPress vẫn giữ nguyên trải nghiệm quen thuộc của Rank Math.

Cấu trúc plugin

Plugin được thiết kế gọn nhẹ với cấu trúc tối giản:

rank-math-info/
├── rank-math-info.php
└── readme.md

• rank-math-info.php: Chứa toàn bộ logic chính của plugin
• readme.md: Mô tả plugin, cách sử dụng và thông tin kỹ thuật

Tóm lại, Rank Math Info được Webo phát triển để giải quyết đúng bài toán đó. Plugin không thay đổi cách Rank Math hoạt động, không thêm logic SEO mới, cũng không làm phức tạp hệ thống. Thay vào đó, Rank Math Info chỉ làm một việc duy nhất: đưa dữ liệu SEO quan trọng của Rank Math ra REST API một cách chuẩn, nhẹ và kiểm soát được.