---
name: seo-knowledge-graph
description: |
  Knowledge Graph and entity SEO analysis. Triggers: knowledge panel, entity SEO, knowledge graph, PAA, FAQ schema, Wikipedia, Wikidata, brand entity.
---

# 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 **Ahrefs serp-overview** 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 |
| Ahrefs `serp-overview` | 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.

## 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