Airygen SEO – SEO 및 GEO를 위한 토픽 클러스터

설명

Airygen SEO는 워드프레스 퍼블리셔가 더 강력한 주제 클러스터를 구축하고, 내부 링크 기회를 발견하며, llms.txt 및 Markdown 내보내기와 같은 AI가 읽을 수 있는 사이트 파일을 생성하도록 돕습니다.

콘텐츠가 많은 사이트를 위해 설계되었으며, 더 나은 구조, 더 강력한 내부 링크, 그리고 현대적인 AI 검색 가시성(GEO)을 제공합니다. 최신 워드프레스 사이트와 PHP 8.1+ 환경에 맞게 설계되었습니다.

무엇이 그것을 다르게 만드는가

• 토픽 클러스터 마인드맵 — 콘텐츠 전반에서 피벗, 클러스터, 지원 관계를 시각화하고, 어떤 클러스터에도 속하지 않는 글을 찾아보세요.
• 내부 링크 제안 및 링크 수 계산 — 새 내부 링크가 들어가야 할 위치를 보여주고, 각 글이 얼마나 잘 연결되어 있는지 확인하세요.
• 사이트 전체 SEO 평가 — 하나의 게시물만이 아니라 사이트 전체를 점수화하세요.
• llms.txt 및 에이전트를 위한 Markdown — LLM과 에이전트가 이해할 수 있도록 사이트의 AI 판독 가능 버전을 공개하세요.
• 모듈형 아키텍처 — 실제로 필요한 워크플로우만 켜세요.

원할 때 바로 사용할 수 있는 완전한 SEO 툴킷

Airygen SEO는 완전한 모듈형 SEO 플랫폼이기도 합니다. 원하실 경우, 온페이지 및 기술적 SEO까지도 맡길 수 있습니다:

• 제목, 설명, 정규 URL, robots 지시문, 집중 키프레이즈를 위한 페이지 내 SEO 필드와 실시간 콘텐츠 점수, SERP 스니펫 미리보기.
• 글, 웹사이트, 조직, 작성자, 그리고 이동 경로 컨텍스트를 위한 스키마 마크업.
• XML 사이트맵, robots 제어, 리다이렉트, 404 로그 기록 및 깨진 링크 모니터링.
• 오픈 그래프 및 트위터 / X 소셜 카드.
• 이미지 SEO, 로컬 SEO, 작성자 SEO, 택소노미 SEO, hreflang, RSS 피드 서명, 그리고 WooCommerce SEO.
• 즉시 인덱싱, 사이트 인증, 알림 통합.

전체 소스 코드는 GitHub에서 확인할 수 있습니다. 기능 요청, 버그 रिपोर्ट, 기여를 환영합니다: https://github.com/airygen/airygen-seo

주요 기능

• 사이트 소유자가 실제로 필요한 워크플로를 활성화할 수 있도록 하는 모듈식 SEO 아키텍처.
• 점수 지원과 검색 결과 너비 알림 기능이 포함된 SEO 제목 및 설명 관리.
• 글, 항목, 더 넓은 사이트 컨텍스트에 대한 canonical 및 robots 제어.
• 더 풍부한 소셜 공유를 위한 Open Graph 및 트위터 / X 카드 출력.
• 중요한 프런트엔드 컨텍스트를 위한 스키마 마크업 생성.
• XML 사이트맵 지원 및 관련 크롤링 제어.
• 탐색경로, 목차, 관련 글, 그리고 콘텐츠 구조를 강화하는 토픽 클러스터 기능.
• 내부 링크 제안, 링크 수 계산, 그리고 시간이 지남에 따라 콘텐츠 품질을 향상시키기 위한 사이트 전체 SEO 평가.
• 리다이렉트, 404 도구, 그리고 유지 관리 및 정리를 위한 깨진 링크 확인.
• 구성 가능한 템플릿을 사용하여 누락된 이미지 속성을 채우는 런타임 이미지 SEO.
• 운영 SEO 워크플로우를 위한 즉시 색인, 사이트 인증 및 알림 모듈.
• 로컬 SEO, 작성자 SEO, 택소노미 SEO, hreflang, RSS 피드 서명, 그리고 WooCommerce SEO 확장.
• 현대적인 퍼블리싱 워크플로를 위한 LLMs.txt 및 에이전트용 마크다운 도구.

소스 코드

이 플러그인의 전체 사람이 읽을 수 있는 소스 코드는 배포된 build/ 디렉터리 아래의 모든 파일을 생성하는 데 사용된 압축되지 않은 JavaScript, TypeScript, JSX 및 SCSS 소스를 포함하여 GitHub에서 확인할 수 있습니다:

https://github.com/airygen/airygen-seo

build/ 아래에 포함된 모든 컴파일된 파일에는 압축되지 않은 헤더 댓글이 포함되어 있으며, 이는 해당 파일의 소스 진입점, 소스 디렉터리, 그리고 위의 저장소 URL을 가리킵니다. 아래의 매핑은 이 관계를 완전하게 문서화하여, 누구나 모든 컴파일된 자산의 사람이 읽을 수 있는 소스를 찾을 수 있도록 합니다.

build/ 디렉터리가 생성되는 방법

build/ 디렉터리는 @wordpress/scripts에 의해 생성됩니다(내부적으로 webpack 5, Babel, PostCSS, Sass를 사용합니다). 빌드 엔트리 포인트는 package.json(scripts.build)에 선언됩니다:

• `wp-scripts build block-editor=./packages/block-editor/src/index.tsx --output-path=build/block-editor --output-filename=airygen-editor.js`
• wp-scripts build classic-editor=./packages/classic-editor/src/index.tsx --output-path=build/classic-editor --output-filename=airygen-editor.js
• `wp-scripts build ./packages/admin/app.tsx --output-path=build/admin --output-filename=airygen-app.js`

wp-scripts build가 완료된 후 pnpm build 스크립트는 node scripts/build-banner.mjs를 실행하며, 이 스크립트는 생성된 각 JS 및 CSS 파일의 맨 앞에 /*! ... */ 헤더를 추가합니다. 이 헤더에는 파일의 원본 엔트리, 원본 디렉터리, 저장소 URL, 빌드 명령이 포함됩니다. 이 스크립트는 멱등적이므로, 다시 실행해도 기존 Airygen SEO 배너를 그 위에 덧붙이지 않고 기존 배너를 교체합니다.

소스-빌드 매핑

번들: build/admin/

• build/admin/airygen-app.js — 엔트리 packages/admin/app.tsx에서 컴파일됨. packages/admin/components/, packages/admin/pages/, packages/admin/utils/, packages/admin/types/, packages/admin/constants/, packages/admin/styles/ 아래의 모듈과 packages/shared/ 아래의 공유 모듈을 포함합니다.
• build/admin/app.tsx.css 및 build/admin/app.tsx-rtl.css — tailwind.config.js에 따라 packages/admin/**/*.{tsx,ts} 전반의 클래스 이름을 스캔하는 Tailwind CSS와, postcss.config.js에 선언된 PostCSS 플러그인(Tailwind CSS + Autoprefixer)을 사용해 packages/admin/styles/tailwind.css에서 컴파일됩니다.
• `build/admin/airygen-app.asset.php` — `@wordpress/dependency-extraction-webpack-plugin`에 의해 생성된 자동 생성 의존성 매니페스트입니다. 수동으로 작성된 것이 아닙니다.

Bundle: build/block-editor/” -> “번들: build/block-editor/

• build/block-editor/airygen-editor.js — packages/block-editor/src/index.tsx 엔트리에서 컴파일됨. packages/block-editor/components/, packages/block-editor/hooks/, packages/block-editor/utils/, packages/block-editor/config.ts, packages/block-editor/types.ts 아래의 모듈과 packages/shared/ 아래의 공유 모듈을 불러옵니다.
• build/block-editor/style-block-editor.css 및 build/block-editor/style-block-editor-rtl.css — packages/block-editor/style.scss와 그 아래 packages/block-editor/에서 가져오는 모든 .scss 파일을 Sass와 PostCSS로 처리하여 컴파일한 것입니다.
• `build/block-editor/airygen-editor.asset.php` — 자동 생성된 종속성 매니페스트.

번들: build/classic-editor/

• build/classic-editor/airygen-editor.js — packages/classic-editor/src/index.tsx 엔트리에서 컴파일됨. packages/classic-editor/components/ 아래의 모듈과 packages/shared/ 아래의 공유 모듈을 불러옵니다.
• build/classic-editor/style-classic-editor.css 및 build/classic-editor/style-classic-editor-rtl.css — packages/classic-editor/style.scss와 packages/classic-editor/ 아래에서 가져오는 모든 .scss 파일에서 Sass 및 PostCSS로 처리되어 컴파일됩니다.
• `build/classic-editor/airygen-editor.asset.php` — 자동 생성된 종속성 매니페스트.

컴파일되지 않은 자산

다음 디렉터리에는 직접 작성한 JavaScript와 CSS가 포함되어 있으며, 이는 그대로(빌드 단계 없이) 배포되고 PHP에 의해 직접 등록됩니다. 이미 사람이 읽을 수 있는 형태이며 build/에 대응하는 항목이 없습니다:

• resources/assets/js/ — faq-preview.js, inline-script-host.js, metabox.js, toc-preview.js, topic-expansion-preview.js.
• `resources/assets/css/style.css` — 공개용 스타일시트.
• `resources/views/**` — PHP 보기 템플릿.

로컬에서 빌드 재현하기

1. Node.js 20 이상과 pnpm 9 이상, 그리고 PHP 8.1 이상과 Composer 2 이상을 설치하세요.
2. 저장소를 복제합니다: git clone https://github.com/airygen/airygen-seo.git.
3. 의존성을 설치하세요: pnpm install 및 composer install.
4. 프로덕션 에셋 빌드: pnpm build.

4단계 이후, 배포된 플러그인에서 build/ 아래에 포함된 동일한 파일들이 로컬에서 다시 생성됩니다. 각 다시 생성된 파일에는 위에서 설명한 동일한 /*! ... */ 헤더가 포함되어, 모든 컴파일된 파일을 공개 소스 경로까지 추적할 수 있게 됩니다.

외부 서비스

이 플러그인은 사이트 관리자가 해당 기능을 활성화하면 다음의 제3자 서비스에 연결합니다. 사이트 관리자가 기능을 활성화하지 않는 한 어떤 데이터도 외부 서비스로 전송되지 않습니다.

Google 지도

Local SEO 모듈이 활성화되고 유효한 좌표가 구성되어 있으면, 플러그인은 https://www.google.com/maps?...&output=embed의 Google Maps iframe을 두 곳에 삽입할 수 있습니다: 프런트엔드 Local SEO 비즈니스 카드 출력과 Local SEO 관리자 미리보기입니다. 이 요청에는 삽입 URL에 구성된 위도/경도가 포함되며, Google은 방문자 또는 관리자 IP 주소와 브라우저 메타데이터와 같은 표준 삽입 요청 데이터를 수신할 수 있습니다.

• Google Maps Platform 서비스 약관
• Google 개인정보처리방침

IndexNow 엔드포인트

Instant Indexing” 모듈이 사용으로 설정되고 사이트 관리자가 IndexNow 키를 구성하면, 플러그인은 각 사용 중인 IndexNow 엔진 엔드포인트로 JSON 요청을 전송합니다. 페이로드에는 사이트 호스팅, 구성된 키, 제출된 URL 목록, 그리고 선택적 키 파일 위치가 포함됩니다. 요청은 자동 공개 또는 삭제 이벤트, Instant Indexing 관리자 화면에서의 수동 제출, 그리고 사이트 관리자가 시작한 백필 작업 중에 발생할 수 있습니다. 현재 기본 제공 엔드포인트는 다음과 같습니다:

• Microsoft Bing: https://www.bing.com/indexnow — Microsoft 서비스 계약, Microsoft 개인정보처리방침
• Yandex: https://yandex.com/indexnow — Yandex 사용자 계약, Yandex 개인정보 처리방침
• Seznam.cz: https://search.seznam.cz/indexnow — Seznam 법적 정보, Seznam 개인정보 처리방침
• 네이버: https://searchadvisor.naver.com/indexnow — 네이버 서비스 약관, 네이버 개인정보처리방침
• Yep (Ahrefs): https://indexnow.yep.com/indexnow — Ahrefs 서비스 약관, Ahrefs 개인정보 처리방침
• IndexNow FAQ

텔레그램 봇 API

Notify 모듈에서 Telegram 알림이 활성화되면, 플러그인은 사이트 관리자가 구성한 봇 토큰과 채팅 ID를 사용하여 https://api.telegram.org로 sendMessage 요청을 보냅니다. 전송되는 페이로드에는 알림 제목과 본문이 포함되며, 설정된 경우 선택적 Telegram 토픽 ID도 포함됩니다.

• Telegram 서비스 약관
• Telegram 개인정보 처리방침

Discord 웹훅

Notify 모듈에서 Discord 알림이 사용으로 설정되면, 플러그인은 사이트 관리자가 구성한 Discord 웹훅 URL로 웹훅 요청을 보냅니다. 전송되는 페이로드에는 알림 제목이 मुख्य 콘텐츠 필드로 포함되고, 메시지 본문은 임베드 설명으로 포함되며, 설정된 경우 표시 이름과 아바타 URL 같은 선택적 웹훅 프로필 필드도 포함됩니다.

• Discord 서비스 약관
• 디스코드 개인정보처리방침

Microsoft Teams 웹후크

Notify 모듈에서 Microsoft Teams 알림이 사용으로 설정되면, 플러그인은 사이트 관리자에 의해 구성된 Teams 웹훅 URL로 웹훅 요청을 보냅니다. 전송되는 페이로드에는 알림 제목과 메시지 본문이 포함됩니다.

• Microsoft 서비스 계약
• Microsoft 개인정보처리방침

SMTP 서비스

Notify 모듈에서 이메일 알림이 사용되면, 플러그인은 사이트 관리자에 의해 설정된 SMTP 서버에 직접 연결합니다. 전송되는 데이터에는 SMTP 호스팅 및 포트, 암호화/인증 설정, 발신자 및 수신자 주소, 알림 제목, 요약 메시지 본문, 그리고 구성된 제공업체에 필요한 SMTP 자격 증명이 포함됩니다. 관리자 UI에는 Gmail, Office 365 / Outlook, Mailgun, SendGrid, Amazon SES, Zoho Mail, Brevo, Postmark용 내장 프리셋이 있으며, 사이트 관리자는 사용자 정의 SMTP 서버 세부 정보도 입력할 수 있습니다.

사이트 관리자가 실제로 선택했거나 수동으로 입력한 SMTP 호스팅만 연결됩니다. 기본값으로는 어떤 SMTP 호스팅에도 연결되지 않습니다. 내장 사전 설정을 선택하면 플러그인은 다음 호스팅에 연결합니다:

• Gmail: smtp.gmail.com:587 — Google 서비스 약관, Google 개인정보처리방침
• Office 365 / Outlook: smtp.office365.com:587 — Microsoft 서비스 계약, Microsoft 개인정보 처리방침
• Mailgun: smtp.mailgun.org:587 — Mailgun 서비스 약관, Mailgun 개인정보 처리방침
• SendGrid: smtp.sendgrid.net:587 — Twilio 서비스 약관, Twilio 개인정보 처리방침
• Amazon SES: email-smtp.us-east-1.amazonaws.com:587 — AWS 서비스 약관, AWS 개인정보 보호 고지
• Zoho Mail: smtp.zoho.com:587 — Zoho 서비스 약관, Zoho 개인정보처리방침
• 브레보: smtp-relay.brevo.com:587 — Brevo 이용 약관, Brevo 개인정보 처리방침
• Postmark: smtp.postmarkapp.com:587 — Postmark 서비스 약관, Postmark 개인정보 처리방침

저작권

Airygen SEO, Copyright 2025 Airygen.com
Airygen SEO는 GNU 일반 공중 라이선스의 항목에 따라 배포됩니다.

이 프로그램은 자유 소프트웨어입니다. Free Software Foundation이 게시한 GNU General Public License의 조건에 따라 이를 재배포하거나 수정할 수 있으며, 라이선스의 제3판 또는 (귀하의 옵션에 따라) 그 이후의 버전 중 어느 하나를 적용할 수 있습니다.

이 프로그램은 유용하게 사용되기를 바라는 마음에서 배포되지만,
상업성 또는 특정 목적에의 적합성에 대한 묵시적 보증을 포함하여, 어떠한 보증도 없습니다.
자세한 내용은 GNU 일반 공중 라이선스를 참조하십시오.