Files
our-claude-skills/custom-skills/17-seo-gateway-architect/code/CLAUDE.md
Andrew Yim f0a1453918 feat(skills): Add mandatory Notion output requirement to all audit skills
All SEO (10-18) and GTM (20-21) skills now require saving reports to:
- Database: OurDigital SEO Audit Log (2c8581e5-8a1e-8035-880b-e38cefc2f3ef)
- Format: Korean content with English technical terms
- Audit ID: [TYPE]-YYYYMMDD-NNN

Updated files:
- 9 SEO skills (code/CLAUDE.md + desktop/SKILL.md)
- 2 GTM skills (code/CLAUDE.md + desktop/SKILL.md)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-22 02:16:26 +09:00

2.5 KiB

CLAUDE.md

Overview

SEO gateway page strategist for Korean medical/service websites. Creates keyword strategies, content architecture, and technical SEO plans.

Quick Start

pip install -r scripts/requirements.txt

# Keyword analysis
python scripts/keyword_analyzer.py --topic "눈 성형" --market "강남"

Scripts

Script Purpose
keyword_analyzer.py Analyze keywords, search volume, competitor gaps

Keyword Analyzer

# Basic analysis
python scripts/keyword_analyzer.py --topic "눈 성형"

# With location targeting
python scripts/keyword_analyzer.py --topic "눈 성형" --market "강남" --output strategy.json

# Competitor analysis
python scripts/keyword_analyzer.py --topic "눈 성형" --competitors url1,url2

Output

Generates strategic document with:

  • Primary keyword + monthly search volume
  • LSI keywords (7-10)
  • User intent distribution
  • Competitor gap analysis
  • Content architecture (H1-H3 structure)
  • Technical SEO checklist

Templates

See templates/ for:

  • keyword-research-template.md
  • content-architecture-template.md
  • seo-checklist-template.md

Workflow

  1. Run keyword analyzer for target topic
  2. Review search volume and intent data
  3. Use output to plan content architecture
  4. Hand off to 18-seo-gateway-builder for content generation

Configuration

# Optional: API keys for enhanced data
GOOGLE_API_KEY=xxx
NAVER_API_KEY=xxx

Notion Output (Required)

IMPORTANT: All audit reports MUST be saved to the OurDigital SEO Audit Log database.

Database Configuration

Field Value
Database ID 2c8581e5-8a1e-8035-880b-e38cefc2f3ef
URL https://www.notion.so/dintelligence/2c8581e58a1e8035880be38cefc2f3ef

Required Properties

Property Type Description
Issue Title Report title (Korean + date)
Site URL Audited website URL
Category Select Technical SEO, On-page SEO, Performance, Schema/Structured Data, Sitemap, Robots.txt, Content, Local SEO
Priority Select Critical, High, Medium, Low
Found Date Date Audit date (YYYY-MM-DD)
Audit ID Rich Text Format: [TYPE]-YYYYMMDD-NNN

Language Guidelines

  • Report content in Korean (한국어)
  • Keep technical English terms as-is (e.g., SEO Audit, Core Web Vitals, Schema Markup)
  • URLs and code remain unchanged

Example MCP Call

mcp-cli call notion/API-post-page '{"parent": {"database_id": "2c8581e5-8a1e-8035-880b-e38cefc2f3ef"}, "properties": {...}}'