Truy vấn Google Knowledge Graph Search API bằng Python để đo điểm Entity Reconciliation Score của Thương hiệu

Trong kỷ nguyên SEO dựa trên Thực thể (Entity-based SEO), tiêu chuẩn cao nhất để xác định một thương hiệu đã chiến thắng trên không gian mạng là khi thuật toán Google chính thức ghi nhận thương hiệu đó vào Sơ đồ tri thức (Google Knowledge Graph) và cấp một mã định danh thực thể duy nhất dạng MID (Machine Identifier - Ví dụ: /m/012345).

Tuy nhiên, làm thế nào để bạn biết chính xác Google đang "hiểu" thương hiệu của bạn được bao nhiêu %, điểm tin cậy thực thể của bạn cao hay thấp so với đối thủ? Câu trả lời nằm ở công cụ Google Knowledge Graph Search API và thuật toán tính toán điểm Entity Reconciliation Score (Điểm tương thích thực thể). Bài viết này sẽ hướng dẫn bạn viết script Python tự động thực thi công việc này.

1. Google Knowledge Graph Search API là gì?

Google Knowledge Graph Search API là giao diện lập trình ứng dụng chính thức do Google cung cấp, cho phép các nhà phát triển tìm kiếm và truy vấn trực tiếp vào Cơ sở dữ liệu tri thức khổng lồ của Google.

Khi bạn gửi một từ khóa tên thương hiệu qua API này, Google sẽ trả về phản hồi JSON chứa:

• Mã định danh thực thể @id (MID).
• Tên thực thể (Name) và Phân loại thực thể (Types: Organization, Corporation, Person).
• Điểm số điểm tương thích resultScore (Độ tự tin của Google về thực thể này).
• Đường dẫn liên kết chi tiết tới trang Wikipedia hoặc Wikidata tương ứng. Read SameAs Schema kết nối Wikidata & Crunchbase.

2. Viết Script Python Truy vấn Google Knowledge Graph API

Trước khi chạy script, bạn cần tạo một API Key miễn phí tại Google Cloud Console (bật Google Knowledge Graph Search API).

Tạo file Python audit_entity.py:

import requests
import json
import pandas as pd

API_KEY = "YOUR_GOOGLE_CLOUD_API_KEY"
SEARCH_QUERY = "Uwmee Software"
API_URL = f"https://kgsearch.googleapis.com/v1/entities:search?query={SEARCH_QUERY}&key={API_KEY}&limit=5&indent=True"

def fetch_entity_score():
    response = requests.get(API_URL)
    if response.status_code != 200:
        print(f"Lỗi truy vấn API: {response.status_code}")
        return

    data = response.json()
    item_list = data.get('itemListElement', [])

    if not item_list:
        print(f"❌ [CẢNH BÁO] Thực thể '{SEARCH_QUERY}' CHƯA ĐƯỢC Google Knowledge Graph nhận diện!")
        return

    print(f"✅ Tìm thấy {len(item_list)} thực thể liên quan trên Google Knowledge Graph:
")

    results = []
    for item in item_list:
        result = item.get('result', {})
        score = item.get('resultScore', 0)
        
        entity_info = {
          'Name': result.get('name'),
          'MID (@id)': result.get('@id'),
          'Types': ', '.join(result.get('@type', [])),
          'Description': result.get('description', 'N/A'),
          'Reconciliation Score': score,
          'Wikipedia URL': result.get('detailedDescription', {}).get('url', 'N/A')
        }
        results.append(entity_info)

    # Xuất bảng báo cáo Pandas DataFrame
    df = pd.DataFrame(results)
    print(df.to_string())

if __name__ == "__main__":
    fetch_entity_score()

Read thêm bài hướng dẫn Phân tích File Log Server bằng Python.

3. 4 Chỉ số Đánh giá trong Báo cáo Entity Reconciliation Score

Thang điểm ResultScore	Mức độ Định danh trên Google	Tác động tới SEO & E-E-A-T	Hành động Kỹ thuật cần làm
Chưa có kết quả (Score = 0)	Chưa được nhận diện thành một Entity độc lập trên Knowledge Graph.	Website dễ dính án phạt thuật toán rác rưởi. Rất dễ bị đối thủ đè bẹp.	Xây dựng ngay Schema Organization sameAs và tạo hồ sơ trên Crunchbase, Google Business. View Entity SEO là gì.
Thấp (Score < 50)	Được nhận diện nhưng thông tin mơ hồ, dễ nhầm lẫn với thực thể khác.	Googlebot chưa hoàn toàn tự tin trích dẫn bài viết.	Chuẩn hóa thông tin NAP Consistency trên 50+ danh bạ. Read NAP Consistency trong Local SEO.
Cao (Score > 200)	Đã thành một Entity chính thống toàn cầu! Có mã MID rõ ràng.	Website được ưu tiên vị trí hiển thị trên Top Stories, Google Discover và AI Overviews. Read SEO Báo điện tử Top Stories.	Duy trì nội dung E-E-A-T và mở rộng các liên kết báo chí truyền thông.

4. Kỹ thuật Nâng cao Điểm Entity Reconciliation Score trong 30 Ngày

1. Đăng ký và Xác minh mã Wikidata Item (QID)

Tạo một trang mục nhập trên Wikidata.org. Điền thuộc tính official website (P856) trỏ về tên miền của bạn và bổ sung các nguồn báo chí uy tín chứng minh tính nổi bật. Read SameAs Schema kết nối Wikidata & Crunchbase.

2. Đồng bộ thuộc tính sameAs trong Schema Organization JSON-LD

Chèn đoạn mã Schema JSON-LD trên trang chủ chứa đầy đủ danh sách các liên kết mạng xã hội chính thức, hồ sơ Crunchbase và mã Wikidata QID:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "SoftwareCompany",
  "@id": "https://uwmee.com/#organization",
  "name": "Uwmee Software",
  "url": "https://uwmee.com",
  "sameAs": [
    "https://www.wikidata.org/wiki/Q12345678",
    "https://www.crunchbase.com/organization/uwmee",
    "https://www.linkedin.com/company/uwmee"
  ]
}
</script>

View bài hướng dẫn Schema Markup JSON-LD chuẩn SEO.

Kết luận

Sử dụng Python truy vấn Google Knowledge Graph API để đo điểm Entity Reconciliation Score là phương pháp kiểm thử đỉnh cao giúp bạn lượng hóa chính xác độ uy tín thương hiệu của mình trên mắt thần Googlebot. Việc kiên trì xây dựng hạ tầng thực thể minh bạch sẽ đưa doanh nghiệp vươn lên vị trí dẫn đầu ngành.