/docs

pSEO Wizard 문서

웹사이트에서 게시된 페이지까지 필요한 모든 것: 마법사의 작동 방식, 코드 없이 페이지를 사이트에 올리는 방법, 문제가 생겼을 때 해결하는 방법을 안내합니다.

최종 업데이트: 2026년 9월

/how-it-works

이용 방법

마법사는 5단계입니다. 결제하기 전이라면 어느 단계로든 돌아가 수정할 수 있습니다.

  1. 01

    웹사이트 붙여 넣기

    홈페이지와 주요 페이지 몇 개(서비스, 가격, 메뉴, 회사 소개, 연락처)를 읽고 업종을 파악합니다. 모든 페이지에 들어갈 핵심 정보도 추가할 수 있습니다.

  2. 02

    패턴 고르기

    “{도시} {서비스}”나 “{대상}을 위한 {제품}”처럼 검색어의 형태를 고르고, 페이지 템플릿을 선택합니다.

  3. 03

    값 입력하기

    조합할 서비스, 도시, 대상을 입력하세요. 조합 하나가 페이지 하나가 됩니다. 지역을 노리는 경우, 고객을 응대하는 방식에 맞는지 확인해 드립니다.

  4. 04

    생성하기

    먼저 무료 페이지를 생성해 보세요. 마음에 들면 나머지를 결제하고(최소 10페이지), 페이지가 하나씩 작성됩니다.

  5. 05

    게시 또는 다운로드

    페이지를 WordPress, Shopify, Webflow, WooCommerce로 보내거나, 바로 업로드할 수 있는 HTML 파일로 내려받으세요.

/html-export

페이지 다운로드

5단계의 번들 다운로드를 누르면 어디에서든 페이지를 호스팅하는 데 필요한 모든 것이 담긴 ZIP 파일을 받을 수 있습니다:

  • dist/페이지마다 완성된 HTML 파일 하나. 스타일이 들어 있어 다른 파일 없이도 제대로 보입니다.
  • dist/index.html모든 페이지를 링크로 모아 둔 간단한 목록.
  • sitemap.xmlGoogle Search Console에 제출할 수 있는 사이트맵.
  • data/같은 페이지를 JSON(제목, 슬러그, 메타 설명, HTML)으로 담은 개발자용 데이터.

온라인에 올리려면

  1. 파일의 압축을 풉니다.
  2. dist/ 안의 파일을 호스팅에 업로드합니다. 가능하면 /blog 폴더에 넣으세요. 호스팅의 파일 관리자나 FTP를 쓰면 됩니다.
  3. 브라우저에서 페이지 하나를 열어 확인한 뒤, Google Search Console에 sitemap.xml을 제출합니다.

/json

개발자용 JSON

다운로드 파일에는 페이지 데이터도 들어 있어, 직접 만든 앱에서 페이지를 제공할 수 있습니다. data/wizard-data.json은 페이지마다 객체 하나가 들어 있는 배열입니다:

data/wizard-data.json의 페이지 객체별 필드
필드타입내용
titlestring검색 결과에 표시되는 페이지 제목(최대 60자).
meta_descriptionstring검색 결과에서 제목 아래에 표시되는 메타 설명.
h1string페이지의 대제목.
body_htmlstring완전한 HTML 문서: head, 인라인 CSS, 구조화된 데이터, “함께 읽기” 링크. 그대로 제공하세요.
slugstring페이지 URL의 마지막 부분(예: plumber-in-camden).
keywordsobject이 페이지에 사용된 값으로, 패턴의 변수마다 하나씩입니다.
statusstring내보낸 페이지는 항상 “success”입니다.
localestring페이지의 언어 코드(예: en, ar).

data/content.json에는 같은 페이지가 들어 있고, 일부 도구가 기대하는 이름 세 가지가 추가됩니다: content(body_html과 같음), metaDescription과 description(둘 다 meta_description과 같음).

페이지 객체 예시(body_html 줄임)

data/wizard-data.json → [0]
{
  "title": "Plumber in Camden | Example Plumbing",
  "meta_description": "Same-day plumbing in Camden: boiler service from £89 and leak repairs by Gas Safe registered engineers.",
  "h1": "Plumber in Camden",
  "body_html": "<!DOCTYPE html><html lang=\"en\" dir=\"ltr\"><head>…</head><body>…</body></html>",
  "slug": "plumber-in-camden",
  "keywords": { "Service": "Plumber", "Area": "Camden" },
  "status": "success",
  "locale": "en"
}

앱에서 페이지 제공하기

페이지 URL에 대한 응답으로 body_html 전체를 그대로 보내세요. 자체 레이아웃으로 감싸지 마세요. head, 스타일, 구조화된 데이터가 이미 들어 있습니다. 사용하는 기술에 맞는 예시를 고르세요:

정적 호스팅(프레임워크 없음)

terminal / nginx
# Put the exported pages under /blog on any static host
unzip your-site-bundle.zip -d export
mkdir -p public/blog
cp export/dist/*.html public/blog/
# /blog/plumber-in-camden.html works now. For /blog/plumber-in-camden,
# turn on "clean URLs" (Netlify, Vercel, Cloudflare Pages) or, on nginx:
location /blog/ {
  try_files $uri $uri.html =404;
}

Next.js

app/blog/[slug]/route.ts
import pages from '@/data/wizard-data.json';

export async function GET(_req: Request, { params }: { params: Promise<{ slug: string }> }) {
  const { slug } = await params;
  const page = pages.find(p => p.slug === decodeURIComponent(slug));
  if (!page) return new Response('Not found', { status: 404 });
  return new Response(page.body_html, {
    headers: { 'Content-Type': 'text/html; charset=utf-8' }
  });
}

Astro

src/pages/blog/[slug].astro
---
import pages from '../../data/wizard-data.json';

export function getStaticPaths() {
  return pages.map(page => ({ params: { slug: page.slug }, props: { page } }));
}

const { page } = Astro.props;
---
<Fragment set:html={page.body_html} />

Nuxt

server/routes/blog/[slug].ts
import pages from '~~/data/wizard-data.json';

export default defineEventHandler((event) => {
  const slug = decodeURIComponent(getRouterParam(event, 'slug') ?? '');
  const page = pages.find(p => p.slug === slug);
  if (!page) throw createError({ statusCode: 404 });
  setHeader(event, 'Content-Type', 'text/html; charset=utf-8');
  return page.body_html;
});

PHP (Laravel)

routes/web.php
use Illuminate\Support\Facades\Route;

Route::get('/blog/{slug}', function (string $slug) {
    $pages = json_decode(file_get_contents(storage_path('app/wizard-data.json')), true);
    $page = collect($pages)->firstWhere('slug', $slug);
    abort_unless($page, 404);

    return response($page['body_html'])
        ->header('Content-Type', 'text/html; charset=utf-8');
});

“함께 읽기” 링크와 /blog URL을 유지하는 방법

  • 페이지 간 링크는 3단계에서 고른 URL 구조를 따릅니다: /blog/{slug}, 언어 접두사를 쓰면 /{prefix}/blog/{slug}. 1단계에서 입력한 웹사이트에서 각 페이지를 정확히 이 경로로 제공하면, 링크와 페이지의 구조화된 데이터가 수정 없이 올바르게 작동합니다.
  • 페이지를 다른 경로에 둔다면 HTML을 직접 고치지 마세요. 모든 “함께 읽기” 링크에는 대상 페이지의 slug가 담긴 data-pseo-link 속성이 있어, 한 번에 바꿀 수 있습니다:
    read-also.js
    // Each "Read also" link carries data-pseo-link="<slug>"
    const html = page.body_html.replace(
      /href="[^"]*"(\s+data-pseo-link="([^"]+)")/g,
      (_, attr, slug) => `href="/guides/${slug}"${attr}`
    );
  • 반면 dist/의 HTML 파일끼리는 {slug}.html 형식으로 연결됩니다. 같은 폴더(가능하면 /blog)에 함께 업로드하면, 깔끔한 URL 설정 여부와 관계없이 잘 작동합니다.
  • 캠페인의 모든 페이지를 함께 가져오세요. 가져오지 않은 페이지로 가는 링크는 404가 됩니다. HTML 내보내기는 이런 링크를 자동으로 없애 주고, 자체 앱에서는 데이터에 없는 slug로 가는 링크를 건너뛸 수 있습니다.
  • 페이지를 게시한 뒤에는 slug를 바꾸지 마세요. 꼭 바꿔야 한다면 이전 주소에서 새 주소로 301 리디렉션을 추가하세요.

/publish

코드 없이 게시하기

5단계에서 사이트를 연결하면 페이지를 대신 보내 드립니다. 플랫폼 키는 한 번만 받으면 되며, 아래 단계에서 어디서 찾는지 알려 드립니다.

WordPress

페이지는 글 임시저장본으로 들어오므로, 게시하기 전에 확인할 수 있습니다.

  1. WordPress 관리자에서 사용자 → 프로필을 열고 애플리케이션 비밀번호까지 스크롤합니다.
  2. “pSEO Wizard” 같은 이름을 입력하고 새 애플리케이션 비밀번호 추가를 클릭한 뒤, 표시된 비밀번호를 복사하세요. 한 번만 표시됩니다.
  3. 5단계에서 WordPress를 선택하고 사이트 주소, WordPress 사용자 이름, 그 애플리케이션 비밀번호(평소 로그인 비밀번호가 아님)를 입력합니다.
  4. 게시를 클릭한 다음 WordPress에서 글 → 임시글을 열어 페이지를 확인하고 게시하세요.

Shopify

페이지는 선택한 블로그에 게시된 글로 추가됩니다.

  1. Shopify 관리자에서 설정 → 앱 및 판매 채널 → 앱 개발을 열고 앱을 만듭니다.
  2. Admin API 범위 구성에서 read_content와 write_content를 켜고 저장한 뒤 앱 설치를 클릭합니다.
  3. API 자격 증명을 열고 shpat_로 시작하는 Admin API 액세스 토큰을 복사합니다.
  4. 5단계에서 Shopify를 선택하고 스토어 주소(yourstore.myshopify.com)와 토큰을 입력한 뒤, 블로그를 고르고 게시를 클릭합니다.

Webflow

페이지는 CMS 컬렉션의 항목으로 추가되며, 다음에 사이트를 게시할 때 공개됩니다.

  1. Webflow Designer에서 리치 텍스트 필드 Post Body와 텍스트 필드 Post Summary가 있는 CMS 컬렉션(예: “가이드”)을 만듭니다. Webflow 블로그 템플릿에는 두 필드가 이미 있습니다.
  2. 컬렉션의 템플릿 페이지를 열고 이름과 Post Body를 레이아웃에 연결합니다.
  3. 사이트 설정 → 앱 및 통합 → API 액세스에서 API 토큰을 만듭니다.
  4. 5단계에서 Webflow를 선택하고 토큰을 붙여 넣은 뒤, 사이트와 컬렉션을 고르고 게시를 클릭한 다음 Webflow에서 사이트를 게시하세요.

WooCommerce

페이지는 상품 임시저장본으로 추가되며, 판매하는 상품에 관한 페이지에 잘 맞습니다.

  1. WordPress 관리자에서 WooCommerce → 설정 → 고급 → REST API를 열고 키 추가를 클릭합니다.
  2. 키에 읽기/쓰기 권한을 주고 소비자 키(ck_…)와 소비자 비밀(cs_…)을 복사합니다.
  3. 5단계에서 WooCommerce를 선택하고 스토어 주소와 두 키를 입력한 뒤 게시를 클릭하고, 상품에서 임시저장본을 확인하세요.

Wix

아직 Wix와 직접 연결되지는 않지만, 페이지를 직접 추가할 수 있습니다.

  1. 5단계에서 페이지를 내려받으세요(위의 “페이지 다운로드” 참고).
  2. Wix 에디터에서 새 페이지를 추가하고 코드 임베드 → HTML 임베드를 넣은 뒤, 페이지 하나의 .html 파일 내용을 전부 붙여 넣습니다.
  3. Wix에서 페이지의 URL과 SEO 제목을 맞게 설정하세요. 검색 엔진은 임베드된 HTML을 일반 페이지보다 잘 읽지 못하므로, 보통 WordPress, Shopify, Webflow가 순위에 더 유리합니다.

/pricing

요금과 결제

페이지마다 한 번만 결제합니다. 구독은 없으며, 모든 계정은 첫 페이지가 무료입니다.

페이지당 가격
페이지페이지당 가격
1–500US$0.30
501–1,500US$0.25
1,501–3,500US$0.20
3,501+US$0.15
  • 요금은 구간별로 적용되며, 각 가격은 해당 구간의 페이지에만 적용됩니다. 예를 들어 600페이지는 500 × $0.30 + 100 × $0.25 = $175입니다.
  • 유료 주문은 최소 10페이지부터입니다. 할인이나 쿠폰 코드는 없습니다.
  • 결제한 캠페인을 변경하면, 아직 생성되지 않은 페이지의 금액이 다음 주문에 쓸 수 있는 크레딧으로 계정에 돌아옵니다.
  • 결제는 판매 대행사(Merchant of Record)인 Dodo Payments가 처리합니다. 카드와 현지 결제 수단을 지원하며, 판매세나 부가가치세는 결제 시 더해집니다.
전체 요금 페이지 보기

/facts

페이지가 정확하게 유지되는 방법

검색 엔진과 고객은 내용을 지어내는 페이지를 외면합니다. 그래서 모든 페이지에 다음 규칙이 적용됩니다:

  • 사실은 웹사이트에서

    가격, 서비스, 후기, 숫자는 웹사이트와 직접 입력한 핵심 정보에서만 가져옵니다. 웹사이트에 없는 숫자는 페이지에서 삭제됩니다.

  • 페이지마다 다른 내용

    페이지마다 고유한 구성안이 있고, 완성된 페이지끼리 서로 비교합니다. 다른 페이지와 너무 많이 겹치는 페이지는 다시 작성됩니다.

  • 지역에 대해 정직하게

    고객이 매장을 찾아오는 경우 너무 먼 지역은 미리 알려 드립니다. 고객에게 찾아가는 경우에는 그 지역에서 서비스한다고만 쓰고, 지점이 있다고는 절대 쓰지 않습니다.

  • /blog 아래에 게시

    페이지는 기본적으로 /blog 폴더에 들어가, 많은 새 페이지를 사이트의 나머지 부분과 분리해 둡니다.

/help

문제 해결

WordPress에서 로그인 정보가 틀렸다고 나와요 (401 또는 403)
평소 비밀번호가 아니라 애플리케이션 비밀번호를 쓰고, 이메일이 아닌 WordPress 사용자 이름을 입력하세요. 일부 보안 플러그인은 WordPress REST API를 차단하므로, 사용자에게 허용한 뒤 다시 시도하세요.
Shopify가 연결되지 않아요
shpat_로 시작하는 Admin API 액세스 토큰을 사용하고, 앱에 read_content와 write_content 범위를 주세요. 범위를 바꾼 뒤에는 앱을 다시 설치하고 새 토큰을 복사하세요.
업로드 후 페이지가 404로 나와요
파일이 페이지 URL이 기대하는 폴더(예: /blog/)에 있는지, 3단계에서 설정한 URL 언어 접두사가 사이트와 일치하는지 확인하세요.
버튼이 엉뚱한 페이지로 연결돼요
버튼은 1단계의 대상 URL이나, 사이트에 해당 페이지(예약, 메뉴, 가격, 연락처)가 있으면 그 페이지로 연결됩니다. 생성 전에 대상 URL을 설정하세요. 이미 만든 페이지는 4단계 페이지 편집기에서 링크를 바꿀 수 있습니다.

그래도 해결되지 않나요? support@wizardseo.co로 메일을 보내 주시면 도와드리겠습니다.