our-claude-skills/custom-skills/28-seo-knowledge-graph/desktop/SKILL.md

name, description

name	description
seo-knowledge-graph	Knowledge Graph and entity SEO analysis. Triggers: knowledge panel, entity SEO, knowledge graph, PAA, FAQ schema, Wikipedia, Wikidata, brand entity, 지식 그래프, 엔티티 SEO, 지식 패널, 브랜드 엔티티, 위키데이터.

Knowledge Graph & Entity SEO

Analyze brand entity presence in Google Knowledge Graph, Knowledge Panels, People Also Ask (PAA), and FAQ rich results. Check entity attribute completeness, Wikipedia/Wikidata presence, and Korean equivalents (Naver knowledge iN, Naver encyclopedia).

Capabilities

Knowledge Graph Analysis

• Knowledge Panel detection and attribute extraction
• Entity attribute completeness scoring (name, description, logo, type, social profiles, website, founded, CEO)
• Wikipedia article presence check
• Wikidata entity presence check (QID lookup)
• Naver encyclopedia (네이버 백과사전) presence
• Naver knowledge iN (지식iN) presence

Entity SEO Audit

• People Also Ask (PAA) monitoring for brand-related queries
• FAQ schema presence tracking (FAQPage schema -> SERP appearance)
• Entity markup audit (Organization, Person, LocalBusiness schema on website)
• Social profile linking validation (sameAs in schema)
• Brand SERP analysis (what appears when you search the brand name)
• Entity consistency across web properties

Workflow

Knowledge Graph Analysis

1. Use WebSearch to search for the entity name on Google
2. Analyze search results for Knowledge Panel indicators
3. Use WebFetch to check Wikipedia article existence
4. Use WebFetch to check Wikidata QID existence
5. Use WebFetch to check Naver encyclopedia and 지식iN
6. Score entity attribute completeness
7. Save report to Notion SEO Audit Log

Entity SEO Audit

1. Use WebFetch to fetch the website and extract JSON-LD schemas
2. Validate Organization/Person/LocalBusiness schema completeness
3. Check sameAs links accessibility
4. Use WebSearch to search brand name and analyze SERP features
5. Monitor PAA questions for brand keywords
6. Use WebSearch for SERP feature detection
7. Save report to Notion SEO Audit Log

Tools Used

Tool	Purpose
WebSearch	Search for entity/brand to detect Knowledge Panel
WebFetch	Fetch Wikipedia, Wikidata, Naver pages, website schemas
WebSearch	SERP feature detection for entity keywords
Notion	Save audit reports to SEO Audit Log database

Notion Output

All reports must be saved to the OurDigital SEO Audit Log database.

Field	Value
Database ID	2c8581e5-8a1e-8035-880b-e38cefc2f3ef
Category	Knowledge Graph & Entity SEO
Audit ID	KG-YYYYMMDD-NNN

Report content should be written in Korean (한국어), keeping technical English terms as-is.

Output Format

{
  "entity_name": "OurDigital",
  "knowledge_panel": {
    "present": false,
    "attributes": {}
  },
  "entity_presence": {
    "wikipedia": false,
    "wikidata": false,
    "wikidata_qid": null,
    "naver_encyclopedia": false,
    "naver_knowledge_in": false,
    "google_knowledge_panel": false
  },
  "entity_schema": {
    "organization_count": 2,
    "person_count": 1,
    "same_as_links": ["https://linkedin.com/...", "https://facebook.com/..."],
    "same_as_count": 2,
    "issues": [
      "Duplicate Organization schemas with inconsistent names",
      "Placeholder image in Organization schema",
      "Only 2 sameAs links (recommend 6+)"
    ]
  },
  "paa_questions": [],
  "faq_schema_present": false,
  "entity_completeness_score": 12,
  "recommendations": [
    "Create Wikidata entity for brand recognition",
    "Add 4-6 more sameAs social profile links",
    "Replace placeholder image with actual brand logo",
    "Consolidate duplicate Organization schemas",
    "Add FAQPage schema to relevant pages"
  ],
  "audit_id": "KG-20250115-001",
  "timestamp": "2025-01-15T14:30:00"
}

Limitations

• Google Knowledge Panel detection via search results is not guaranteed (personalization, location-based)
• Direct Google scraping may be blocked (403/429); prefer WebSearch tool
• Wikipedia/Wikidata creation requires meeting notability guidelines
• PAA questions vary by location and device
• Entity completeness scoring is heuristic-based

Reference Scripts

Located in code/scripts/:

• knowledge_graph_analyzer.py — Knowledge Panel and entity presence analysis
• entity_auditor.py — Entity SEO signals and PAA/FAQ audit
• base_client.py — Shared async client utilities