데모 데이터란?

현재 대시보드의 지표는 데모 시뮬레이션입니다. 정적 사이트(클라이언트 전용)에서는 네이버 데이터랩의 실시간 데이터를 서버 없이 직접 읽을 수 없기 때문에, 실제 데이터와 형태가 유사한 시뮬레이션 값으로 전체 워크플로우를 체험할 수 있도록 만들었습니다.

실제 데이터 연동 방법

간단 요약: 네이버 Developers에서 키를 발급 → Cloudflare Worker에 프록시 배포 → 설정 페이지에 주소 입력. 전체 순서는 실데이터 연결 가이드에 단계별로 정리되어 있습니다.

• 네이버 데이터랩 — 공식 오픈 API(POST naverapihub.apigw.ntruss.com/search-trend/v1/search)로 기간별 상대 관심 지수(0~100)를 받습니다. 순위나 검색량이 아니라, 한 요청에 담긴 5개 그룹 안에서의 상대값입니다. 저장소의 worker/worker.js 프록시가 이 호출을 대신 처리합니다. API 키 필요(애플리케이션 등록).
• 네이버 뉴스·블로그·카페 검색 API — 키워드별 문서 수를 가져와 뉴스·커뮤니티 신호로 사용합니다. 데이터랩과 같은 키로 동작하며, 별도 API 권한(검색 > 뉴스/블로그/카페글)만 추가로 켜면 됩니다. 권한이 없으면 해당 필터는 자동으로 숨겨집니다.
• 구글 트렌드 — 공식 API가 없어 비공식 데이터 소스에 의존해야 하므로 이 앱은 네이버 기준으로만 동작합니다. (연결하지 않는 것을 권장)
• 키 보안 — API 키는 Worker의 Secret에만 저장되어 방문자에게 노출되지 않습니다.

규칙 기반 에이전트란?

이 앱의 에이전트는 5개 레이어 파이프라인(신호 수집 → 관심도 추정 → 성장·경쟁 진단 → 의도·앵글 판단 → 콘텐츠 구조 생성)으로 동작하는 규칙 기반 엔진입니다. 별도 LLM 없이도 즉시 동작하며, 실제 API가 연결되면 각 레이어가 실데이터 기반으로 바뀝니다.

왜 프록시가 필요한가요?

네이버 데이터랩·검색 API는 ① API 키(비밀 값)가 필요하고 ② 브라우저에서 직접 호출하는 것을 차단(CORS)합니다. 그래서 키를 안전하게 보관하고 대신 데이터를 가져와 주는 작은 중계 서버(Cloudflare Worker)가 하나 필요합니다. 아래 순서대로 하면 무료로 설정할 수 있습니다.

네이버 검색어트렌드 API 키 발급

1. 네이버 Developers 에 네이버 계정으로 로그인합니다.
2. Application 등록을 클릭하고, 사용 API에서 데이터랩(검색어트렌드)를 선택합니다.
3. 같은 화면에서 검색 API의 뉴스 / 블로그 / 카페글 도 함께 체크합니다. (뉴스·카페 신호에 필요 — 나중에 추가해도 됩니다)
4. 비로그인 오픈 API 서비스 환경에 WEB 설정을 추가하고, 웹 서비스 URL에 배포한 사이트 주소를 넣습니다.
5. 등록을 완료하면 Client ID와 Client Secret 두 값을 받습니다. (이 두 값이 키입니다 — 절대 공개하지 마세요)

Cloudflare Worker 프록시 배포

1. Cloudflare 무료 계정을 만듭니다.
2. 대시보드에서 Workers & Pages → Create → Worker 를 선택합니다.
3. 이 프로젝트의 worker/worker.js 파일 내용(v3.4.0)을 편집기에 전부 복사해서 붙여넣고 배포(Deploy)합니다.
4. Worker의 Settings → Variables and Secrets 에서 다음 2개를 Secret(암호)으로 추가합니다:
   • NAVER_CLIENT_ID = 위에서 받은 Client ID
   • NAVER_CLIENT_SECRET = 위에서 받은 Client Secret
   검색 API 가 다른 Application 에 등록되어 있다면(API 별로 인증정보가 다른 경우) 아래 2개를 추가로 넣으세요. 넣지 않으면 위 공통 키로 자동 폴백합니다.

   • NAVER_SEARCH_CLIENT_ID = 검색용 Application 의 Client ID
   • NAVER_SEARCH_CLIENT_SECRET = 검색용 Application 의 Client Secret
5. 배포 후 표시되는 Worker 주소(예: https://trendlog-proxy.내계정.workers.dev)를 복사합니다.
6. 브라우저에서 ?action=diag 를 열어 키 상태(길이/공백 여부)와 Claude 키 등록 여부를 확인할 수 있습니다.
7. ?action=signal&keywords=[] 를 열었을 때 available 값이 모두 true 면 검색 API 권한까지 정상입니다.

검색 API 권한 확인 (뉴스·카페 신호)

관심도 그래프(데이터랩)만으로도 앱은 동작하지만, 뉴스·카페 필터를 채우려면 검색 API 권한이 필요합니다.

1. ncloud 콘솔 → NAVER API HUB → Application → API 관리 로 이동합니다.
2. 검색 그룹에서 뉴스 / 블로그 / 카페글 을 체크하고 저장 버튼까지 누릅니다. (체크만 하면 반영되지 않습니다)
3. 워커 주소에 ?action=signal&keywords=["RAG"] 를 붙여 열어 봅니다.
4. "available": { "news": true, "blog": true, "cafe": true } 가 나오면 완료입니다.

사이트에 프록시 주소 입력

1. 설정 페이지의 실데이터 연동 폼을 엽니다.
2. 데이터 소스에서 네이버 데이터랩을 선택합니다.
3. 프록시 주소에 위에서 복사한 Worker URL을 붙여넣습니다.
4. 연결 테스트 버튼을 눌러 연결 성공이 뜨는지 확인합니다.
5. 실데이터 사용을 켜고 연동 설정 저장을 누릅니다.

확인

대시보드로 이동하면 상단 배너가 "실데이터 연결됨"으로 바뀌고, 관심도 차트와 트렌드 피드가 실제 데이터로 표시됩니다. 배너에는 "최근 완료 주 9/21 까지" 처럼 데이터 기준 시점이 함께 표시됩니다.

문제 해결: "401 Authentication failed"

네이버는 두 가지 환경이 있고 주소와 헤더가 서로 다릅니다. 키가 맞는데도 401이 나면 보통 이 불일치가 원인입니다. 워커 v3는 두 방식을 자동으로 감지하므로, 아래처럼 최신 워커로 교체하면 대부분 해결됩니다.

1. 워커를 최신으로 교체 — Cloudflare Worker 편집기에서 코드 전체를 worker/worker.js v3.4.0 내용으로 바꾸고 Deploy.
2. 양쪽 자동 진단 — 브라우저에서 ?action=probe 를 열면 신형·구형 주소를 실제로 호출해 어느 쪽이 인증되는지, 실패하면 네이버 오류 원문까지 보여줍니다. 앱에서는 설정의 401 진단 실행 버튼으로도 가능합니다.
3. 키 자가진단 — ?action=diag 로 length / prefix / hadWhitespace 를 확인합니다. 값은 노출되지 않습니다.
4. 키 재확인 — Client ID/Secret을 복사 버튼으로 다시 복사(눈으로 입력 금지). 가려진 Secret은 재발급.
5. ncloud 사용 설정 확인 — 신형 환경에서 401이 계속되면 ncloud 콘솔의 NAVER API HUB → Application → API 관리 에서 검색어 트렌드 API가 실제로 체크되어 있는지 확인하세요. 권한 미설정도 401을 냅니다.
6. Secret 재등록 후 재배포 — NAVER_CLIENT_ID, NAVER_CLIENT_SECRET 값을 교체하고 Worker를 다시 Deploy.
7. 연결 테스트 — 설정 페이지에서 연결 테스트를 누르면 워커 버전(v3.4.0)이 표시됩니다. 버전이 안 보이면 교체가 반영되지 않은 것입니다.

프록시 응답 형식 (참고)

직접 다른 서버로 프록시를 만들어도 됩니다. 아래 형식만 맞추면 이 앱이 그대로 인식합니다.

GET {proxy}/?action=ping
  → { "ok": true, "provider": "naver", "hasCredentials": true, "hasLlmKey": false, "version": "3.4.0" }

GET {proxy}/?action=probe        ← 401 진단: 두 주소를 실제 호출해 비교
  → {
      "ok": true,
      "anyOk": true,
      "workingMode": "hub",
      "results": {
        "hub":    { "ok": true,  "httpStatus": 200, "points": 14, "sampleRatio": 88.1 },
        "legacy": { "ok": false, "httpStatus": 401, "errorMessage": "Authentication Failed",
                    "hint": "이 키가 NAVER API HUB(ncloud)에서 발급된 키라면 …" }
      }
    }

GET {proxy}/?action=trend&provider=naver&groups=<JSON>
  → {
      "ok": true,
      "provider": "naver",
      "mode": "hub",
      "labels": ["8/1", "8/8", ...],
      "rangeEnd": "2026-09-27",
      "trimmedPartial": true,
      "series": [
        { "name": "AI 에이전트", "data": [ 42, 44, 51, ... ] },
        { "name": "로컬 LLM",   "data": [ 30, 33, 36, ... ] }
      ]
    }

※ rangeEnd / trimmedPartial : 진행 중인 주(부분 집계)를 잘라냈음을 알려주는 정보

GET {proxy}/?action=signal&keywords=["RAG","AI 에이전트"]   ← 뉴스·블로그·카페 문서 수
  → {
      "ok": true,
      "available": { "news": true, "blog": true, "cafe": true },
      "items": [
        { "kw": "RAG", "news": 812, "blog": 4210, "cafe": 138, "total": 5160 }
      ]
    }

※ available : 권한이 없는 유형은 false → 앱이 해당 필터를 자동으로 숨깁니다.

POST {proxy}/?action=llm   ← Claude 이미지 제안 (ANTHROPIC_API_KEY 필요)
  body: { "keyword":"AI 코딩", "intent":"방법·How-to",
          "outline":[{"level":"h2","text":"1. 왜 주목받나"}] }
  → {
      "ok": true,
      "source": "claude",
      "model": "claude-sonnet-5-5",
      "images": [
        { "slot":"hero", "role":"대표 이미지 (썸네일·OG)", "size":"1200x630",
          "alt":"AI 코딩 도구 화면", "filename":"ai-coding-hero.jpg",
          "caption":"…", "prompt":"Editorial hero image …" }
      ]
    }

※ 키가 없으면 501 + 안내를 돌려주고, 앱은 규칙 기반 제안으로 자동 폴백합니다.