Communitygithub.com

Varnan-Tech/opendirectory

Google Trends 데이터를 활용한 블로그 생성을 위한 SEO 키워드 리서치 워크플로우입니다. 블로그 게시물 작성, 콘텐츠 캘린더 계획, 또는 검색 엔진 최적화가 필요할 때 사용하세요. 급상승 키워드를 찾고, 콘텐츠 구조를 구축하며, 기술 및 개발자 대상의 SEO 최적화 블로그 개요를 생성합니다.

opendirectory란 무엇인가요?

이 기술은 블로그 콘텐츠를 작성하기 전에 Google Trends의 RELATED_QUERIES와 RELATED_TOPICS 데이터를 활용하여 SEO 키워드 리서치를 자동화하는 워크플로우입니다. 사용자가 블로그 주제를 입력하면, 해당 기술은 먼저 급상승 키워드(Breakout), 고성장 키워드, 롱테일 키워드 순으로 우선순위를 매겨 최적의 프라이머리 키워드를 선정합니다. 그런 다음 관련 주제(RELATED_TOPICS)를 기반으로 H2 섹션 제목을 추출하고, 롱테일 질문을 H3 부제목으로 활용하여 구조화된 블로그 아웃라인을 생성합니다. 선택적으로 TIMESERIES 데이터로 트렌드 유효성을 검증할 수도 있습니다. 이 기술은 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 환경에서 사용되며, SerpAPI를 통해 Google Trends 데이터에 접근합니다. 최종 산출물은 제목, 메타 설명, H1-H3 구조, 키워드 배치 규칙, 그리고 품질 체크리스트를 포함한 완전한 블로그 개요입니다. 개발자와 기술 블로거를 대상으로 하며, 콘텐츠가 자연스럽게 읽히면서 SEO 성능을 극대화하도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Varnan-Tech/opendirectory/tree/main/skills/google-trends-api-skills/seo-keyword-research

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

SEO 키워드 리서치 기술

블로그 콘텐츠를 작성하기 전에 트렌딩하고 기회가 높은 키워드를 찾으세요. 이 기술은 일반적인 블로그 주제를 SEO 최적화된, 실제로 상위 노출되는 콘텐츠로 바꿔줍니다.

사용 시점

  • 사용자가 블로그 게시물이나 글 작성을 요청할 때
  • 사용자가 특정 주제에 대한 키워드 리서치를 원할 때
  • 사용자가 콘텐츠 캘린더나 콘텐츠 계획이 필요할 때
  • 사용자가 기존 콘텐츠를 SEO에 맞게 최적화하려 할 때
  • 기술/개발자 대상 블로그 생성 작업 시

핵심 원칙

블로그 콘텐츠를 생성하기 전에 항상 키워드를 먼저 리서치하세요.

나쁨: 블로그 작성 -> 상위 노출 기대 -> 대개 실패
좋음: 키워드 리서치 -> 급상승 기회 발견 -> 최적화된 블로그 작성 -> 상위 노출 성공

키워드 우선순위 시스템

Google Trends의 RELATED_QUERIES 결과를 분석할 때, 키워드의 우선순위는 다음과 같습니다:

1. 급상승 키워드 — 최우선 순위

  • formatted_value: "Breakout" = 5000% 이상 성장
  • 경쟁이 매우 낮음 (새로운 트렌드)
  • 블로그의 프라이머리 키워드로 사용
  • 즉시 콘텐츠 생성 (퍼스트 무버 이점)

2. 고성장 키워드 — 매우 높은 우선순위

  • formatted_value: "+100%" 이상
  • 경쟁 낮음~중간
  • 프라이머리 또는 강력한 세컨더리 키워드로 사용
  • 2~4주 이내에 콘텐츠 생성

3. 중간 성장 키워드 — 높은 우선순위

  • formatted_value: "+50%" ~ "+99%"
  • 경쟁 중간 수준
  • 본문 콘텐츠의 세컨더리 키워드로 사용

4. 롱테일 키워드 — 전략적 우선순위

  • 질문 기반 쿼리 (어떻게, 무엇, 왜, 언제, 어디서)
  • 경쟁 낮음, 전환율 높음
  • H3 제목으로 사용 — 추천 스니펫 및 음성 검색 타겟팅

5. 확립된 키워드 — 중간 우선순위

  • 안정적인 관심도와 높은 경쟁을 가진 상위 쿼리
  • 본문 콘텐츠에 사용, 프라이머리 타겟으로는 부적합

SEO 리서치 워크플로우

1단계: 키워드 발견 (API 호출 1회 — 필수)

사용자의 블로그 주제로 RELATED_QUERIES 질의:

curl -s "https://serpapi.com/search?engine=google_trends&q=사용자_주제&data_type=RELATED_QUERIES&date=today+3-m&api_key=$SERPAPI_KEY"

응답에서 다음을 추출:

  • 급상승 키워드 → 프라이머리 키워드 후보
  • 고성장 키워드 (+100%) → 세컨더리 후보
  • 질문 기반 쿼리 → H3 제목 및 추천 스니펫 타겟

프라이머리 키워드 선정:

  1. 첫 번째 급상승 키워드 (있는 경우)
  2. 없다면 첫 번째 고성장 키워드
  3. 없다면 점수 기준 상위 쿼리

2단계: 콘텐츠 구조 (API 호출 1회 — 필수)

동일한 주제로 RELATED_TOPICS 질의:

curl -s "https://serpapi.com/search?engine=google_trends&q=사용자_주제&data_type=RELATED_TOPICS&date=today+3-m&api_key=$SERPAPI_KEY"

급상승 및 상위 결과에서 주제 제목 추출. 이 제목들이 H2 섹션 제목이 됩니다 (3~5개 선택).

3단계: 트렌드 검증 (API 호출 1회 — 선택 사항)

여러 후보 키워드 중 선택하거나 실행 가능성을 검증할 때만 사용:

curl -s "https://serpapi.com/search?engine=google_trends&q=키워드&data_type=TIMESERIES&date=today+12-m&api_key=$SERPAPI_KEY"

최근 2개월 평균과 이전 2개월 평균 비교. 최근 값이 더 높으면 트렌드 상승 — 진행. 하락세라면 다른 키워드 고려.

4단계: 블로그 아웃라인 생성

다음 구조로 아웃라인 작성:

제목: [프라이머리 키워드] — [혜택/숫자] [연도]
  (최대 60자, 프라이머리 키워드 필수 포함)

메타 설명: (150~160자, 프라이머리 + 세컨더리 키워드 1~2개)

# [H1 — 제목과 동일하거나 변형]

## 서론 (150단어)
  - 처음 100단어 안에 프라이머리 키워드 배치
  - 문제나 질문으로 독자 유인
  - 배울 내용 미리 알리기

## [H2: 2단계에서 얻은 관련 주제 1]
### [H3: 1단계에서 얻은 롱테일 질문]
  질문에 답하는 콘텐츠 (150~200단어)
### [H3: 다른 롱테일 질문]
  콘텐츠 (150~200단어)

## [H2: 관련 주제 2]
### [H3: 롱테일 질문]
### [H3: 롱테일 질문]

## [H2: 관련 주제 3]
### [H3: 롱테일 질문]
### [H3: 롱테일 질문]

## 결론 (100단어)
  - 핵심 요점 요약
  - 프라이머리 키워드 1회 언급
  - 행동 유도

목표: 총 1500~2500단어

키워드 배치 규칙

위치규칙
제목프라이머리 키워드 포함, 최대 60자
H1제목과 동일하거나 약간 변형
H2 제목 (3~5개)관련 주제 사용, 자연스러운 언어
H3 제목 (8~12개)롱테일 키워드 사용, 질문 형식
첫 번째 문단처음 100단어 안에 프라이머리 키워드
본문 콘텐츠프라이머리 키워드 12% 밀도, 세컨더리 0.51%
결론프라이머리 키워드 1회
메타 설명프라이머리 + 세컨더리 12개, 150160자

절대 키워드를 강제로 채우지 마세요. 콘텐츠는 자연스럽게 읽혀야 합니다. 구글은 부자연스러운 반복을 패널티합니다.

품질 체크리스트

블로그 생성 전에 다음을 확인하세요:

  • 급상승 또는 +100% 키워드를 최소 1개 찾았음 (또는 확립된 키워드를 사용하는 이유를 정당화)
  • RELATED_TOPICS에서 H2 주제 3~5개 확보
  • H3 제목에 사용할 롱테일 키워드 확보
  • 프라이머리 키워드가 랭킹에 충분히 구체적임
  • 블로그 구조가 위의 아웃라인 템플릿을 따름
  • 메타 설명 작성 완료 (150~160자)
  • 목표 분량 1500~2500단어

만약 해당 주제에 급상승 또는 고성장 키워드가 없다면, 사용자에게 SEO 기회가 제한적임을 알리고 성장 가능성이 있는 대체 각도나 관련 주제를 제안하세요.

예산 인식

무료 티어: 월 250회 검색

전략블로그당 호출 수월 최대 블로그 수
최소 (권장)2125개
표준383개
완전462개

기본적으로 2회 호출(RELATED_QUERIES + RELATED_TOPICS)을 사용하세요. TIMESERIES나 GEO_MAP은 특별히 필요할 때만 추가하세요.

피해야 할 일반적인 실수

  1. 리서치 생략 — 트렌드 확인 없이 글을 쓰면 급상승 기회를 놓침
  2. 급상승 키워드 무시 — 급상승 변형이 존재하는데 일반 용어 사용
  3. 키워드 채우기 — 키워드를 부자연스럽게 반복; 밀도 1~2% 유지
  4. 롱테일 키워드 누락 — 추천 스니펫 및 음성 검색 기회 상실
  5. 일반적인 H2 제목 — 항상 RELATED_TOPICS 데이터를 섹션 구조에 사용

예제 스크립트

완전한 작업 예제를 실행하려면:

python scripts/blog_seo_research.py "블로그 주제"

구현 코드는 scripts/blog_seo_research.py를 참조하세요.

참고 자료

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Varnan-Tech/opendirectory

Use when the user asks to generate a blog cover image, thumbnail, or article header. Automatically uses modern typography, brand logos, and Google Search grounding to create beautiful 16:9 images with Gemini 3.1 Flash Image Preview.

Varnan-Tech/opendirectory

World-class brand strategist and naming expert. Uses an interrogation-led discovery phase to extract your brand's DNA, then applies scientific naming frameworks (Phonosemantics) and automated multi-TLD domain checking.

Varnan-Tech/opendirectory

Use when the user asks to generate or update a project's CLAUDE or AGENTS context file from a codebase scan. Writes a focused file under 100 lines containing only the non-obvious build commands, conventions, and gotchas Claude Code needs.

Varnan-Tech/opendirectory

Use when the user wants to verify cold emails, enrich a lead list, or autonomously guess email addresses from a CSV using ValidEmail.co or the open-source Reacher engine.

Varnan-Tech/opendirectory

Competitive intelligence orchestrator tracking companies across 8+ platforms (GitHub, Twitter, Reddit, HN, PH, YC Jobs) with heat scores and AI briefings.

Varnan-Tech/opendirectory

Give it your product URL or description. It finds your top 5 competitors, runs three-track PR research across all of them (editorial, podcasts, communities), identifies which channels appear most frequently, looks up the journalist or host for each, and returns a tiered outreach list with story angles and ready-to-send cold pitch drafts tailored to your product. Use when asked to find PR opportunities, discover where competitors got featured, build a media outreach list, find which journalists cover my space, or get pitch templates for press coverage.

Varnan-Tech/opendirectory

Generate high-converting, deep-dive growth case studies in MDX format. Use this skill when asked to write a case study or blog post about a company's growth, tech stack, or product-led strategy. It handles the full pipeline (researching the company via Tavily, generating a 16:9 cover image, quality checking the draft, uploading assets to cloud storage, and pushing directly to the target repository).

Varnan-Tech/opendirectory

Scans your project for outdated npm, pip, Cargo, Go, or Ruby packages. Runs a CVE security audit. Fetches changelogs, summarizes breaking changes with Gemini, and opens one PR per risk group (patch, minor, major). Includes Diagnosis Mode for install conflicts. Use when asked to update dependencies, check for outdated packages, open dependency PRs, scan for package updates, audit for CVEs, or flag breaking changes in upgrades. Trigger when a user says "check for outdated packages", "update my dependencies", "open PRs for dependency updates", "scan for CVEs", or "which packages need upgrading".

Varnan-Tech/opendirectory

Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture. Uses graphify to build a knowledge graph first, then writes accurate docs from it. Use when asked to write docs, generate a README, document an API, update stale docs, create an API reference from code, add an architecture section, or document a project in any language. Trigger when a user says their docs are missing, outdated, or wants to document their codebase without writing it manually.

Varnan-Tech/opendirectory

Evaluates expired domain candidates against a target niche, scores them by topical relevance, historical activity level, and history cleanliness, then outputs a ranked shortlist with explainable reasoning and risk flags.

Varnan-Tech/opendirectory

Brutally honest developer-experience audit for a GitHub repo. Scores 10 DX dimensions (time-to-first-success, README clarity, visual proof, install, quick-start, docs, examples, community, trust, marketing), writes a shareable roast in the requested tone (brutal/honest/kind), produces a prioritized action plan ranked by impact × effort, and sketches an ideal README. Trigger when user says "roast my repo", "audit my README", "dx audit", "developer experience review", "score my GitHub project", "before launch checklist", or "make my repo shareable".

Varnan-Tech/opendirectory

Drafts and designs a complete HTML email newsletter from a topic or content brief. Outputs paste-ready HTML for Loops, Mailchimp, Beehiiv, Resend, or any standard email platform. Includes subject line options and plain-text fallback. Trigger when a user says "write a newsletter", "draft an email newsletter", "create an HTML email", "design an email for my subscribers", or "write a newsletter about [topic]".

Varnan-Tech/opendirectory

Takes a GitHub PR URL or the current branch and writes a plain-English explanation of what it does and why, then posts it as a PR comment. Use when asked to explain a PR, summarize a pull request, write a plain-English description of a PR, add a summary comment to a PR, or understand what a PR changes. Trigger when a user says "explain this PR", "summarize this pull request", "what does this PR do", "add a comment explaining the PR", or shares a GitHub PR URL and asks what it does.

Varnan-Tech/opendirectory

Audit how often LLMs recommend your brand vs competitors and generate a GEO action plan.

Varnan-Tech/opendirectory

Takes a competitor's public GitHub repo URL, fetches their open issues via the GitHub REST API, filters noise locally, clusters issues into 6 demand categories, computes a demand score per issue and per cluster, and outputs a ranked demand gap report with a GTM messaging brief. Use when asked to scan a competitor's GitHub issues, find what their users are begging for, turn GitHub complaints into product positioning, identify competitor feature gaps, or generate messaging from real user demand. Trigger when a user says "scan competitor issues", "what are users asking for on X repo", "find demand gaps in Y", "turn GitHub issues into messaging", or "what should I build based on competitor complaints".

Varnan-Tech/opendirectory

Find recurring confusion in your repo's GitHub Discussions, rank it by urgency, and draft the actual docs fixes and content angles — with verbatim community quotes and source links as evidence.

Varnan-Tech/opendirectory

Generates a professionally designed case study PDF for B2B SaaS sales and marketing. Supports 7 page layouts, 9 style presets, 1-4 page output. Trigger when user says "create a case study", "write a customer story", "make a case study PDF", "design a success story", "turn this customer win into a PDF".

Varnan-Tech/opendirectory

Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6. 1080×1080px default, 5 style presets, highlight annotations. Trigger when user says "create a chart", "visualize data", "make a bar chart", "line graph", "pie chart", "data visualization", "chart this data", "plot", "graph", or "visualize these numbers".

Varnan-Tech/opendirectory

Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF. 3–10 pages, 9 style presets, 11 page layout types. Trigger when user says "create an ebook", "design a lead magnet", "make a PDF guide", "build a gated content piece", "write a B2B ebook", "design a white paper", "create a nurture asset", or "make a PDF report".

Varnan-Tech/opendirectory

Fetches low-star App Store and Google Play reviews, clusters them into broken-promise patterns, and generates a ranked copy brief with positioning opportunities.

관련 스킬