132 lines
4.5 KiB
Markdown
132 lines
4.5 KiB
Markdown
---
|
|
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, 지식 그래프, 엔티티 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
|
|
|
|
```json
|
|
{
|
|
"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
|