// docs / quickstart

빠른 시작

가입하고, 첫 번째 스캔을 실행하고, 보고서를 읽으세요. Free 플랜은 실제로 사용 가능합니다 — 평가에 신용카드가 필요하지 않습니다.

/sign-in 에서 Google, GitHub 또는 매직 링크 이메일을 선택하세요. 새 계정은 Free 플랜에서 시작하며, 월 3회 스캔과 패시브 스캔만 포함됩니다. 계정 → 결제 에서 나중에 업그레이드할 수 있습니다.

2. 스캔 실행

대상 선택

대시보드에서 새 스캔을 클릭하고 URL을 붙여넣은 뒤 제출하세요. FixWeb는 bare hostname(example.com → https://example.com)을 정규화하고 내부 주소(RFC 1918, link-local, AWS metadata)는 거부합니다.

~20초 대기

A passive scan runs in three phases: crawl (Chromium renders the page to discover links, metadata, media, scripts, and forms), quality checks (crawlability, search presentation, content/schema, media, performance, accessibility, forms, mobile/i18n, and runtime signals), and aggregate (deduplicate + severity ranking). Live progress streams via the dashboard; you don't need to refresh.

보고서 읽기

The report opens automatically when complete. Free plan users see only the highest-severity finding in full (title, description, evidence, remediation); other findings are stripped to severity-only stubs server-side. The Hobby plan and higher (Pro, Unlimited) unlock every finding plus the AI prompt copy button on each one.

3. Run an owner-depth scan (optional, Hobby plan and higher)

Owner-depth scans extend the same website-quality checks into verified domains and can include private journeys when you provide a short-lived test-account header. Add and verify a domain at Dashboard -> Domains (DNS TXT or HTTP file), then start an Owner-depth scan from New scan. You'll attest to the scan; we audit-log it server-side.

4. REST API 사용

계정 → API 토큰에서 bearer token을 발급하세요. 평문 값은 한 번만 표시되므로 CI / Cursor / curl에 붙여넣어 보관하세요.

curl

# Start a passive scan
curl -X POST https://fixweb.app/api/v1/scans \
  -H "Authorization: Bearer fxw_..." \
  -H "content-type: application/json" \
  -d '{"target":"https://staging.example.com"}'

전체 참조는 /docs/api에서 볼 수 있습니다.

5. AI 에이전트에 FixWeb 연결(MCP)

FixWeb는 /api/mcp에 MCP 서버를 제공합니다. 7개 도구, 2개 리소스, 템플릿 기반 수정 프롬프트를 위한 /fixweb-fix slash command가 포함됩니다. Claude Desktop / Cursor / Continue에 연결하세요. 자세한 내용은 /docs/mcp를 참고하세요.

다음으로 볼 내용

Scan types — passive vs owner-depth vs GitHub repo scans, the attestation flow.
Domains — verify a domain, schedule re-scans, enable live monitoring.
할당량 및 제한 — 플랜별 한도, API rate limit, 보존 정책.

막혔나요?

support@fixweb.app 으로 스캔 ID와 예상한 내용 대비 실제로 본 내용을 알려주세요. Hobby 플랜은 표준 지원, Pro 플랜은 우선 지원, Unlimited 플랜은 전담 지원이 제공됩니다.

1. 계정 만들기