인성이
AI 에이전트로그인 / 가입
공식 배포용 AI 스킬 · 플러스 & 프로 전용

AI 에이전트에 인성이블로그 연결하기

Claude Code, Cursor, ChatGPT 등 선호하는 AI 에이전트에서 내 블로그 글 초안 생성과 이웃 댓글 검토를 대화하듯 직접 실행할 수 있습니다.

스킬이 하는 일

블로그 글 초안 작성
사진 경로와 간단한 방문 메모만 전달하면, AI가 학습된 내 말투(페르소나)로 네이버 블로그용 제목, 본문, 추천 해시태그 초안을 만듭니다.
이웃 새글 댓글 검토 & 승인
대기 중인 댓글 목록을 불러와 에이전트와 대화하며 검토하고, 마음에 드는 댓글만 골라 승인 요청 링크를 받습니다. 실제 승인은 항상 웹에서 내가 직접 누릅니다.
계정 및 실시간 사용량 확인
이번 달 남은 AI 글쓰기 횟수와 오늘 남은 일일 댓글 한도를 언제든 CLI 명령어로 즉시 조회합니다.
안전한 브라우저 연동 게시
승인된 댓글은 내 PC의 Chrome 확장이 사용자 세션으로 직접 게시합니다. 서버는 네이버 비밀번호나 세션 쿠키를 보관하지 않습니다.

누가 사용할 수 있나요?

인성이 AI 스킬 및 공개 API는 플러스(Plus, ₩9,900/월) 및 프로(Pro, ₩3,900/월) 요금제 회원에게 제공됩니다. 무료 회원은 브라우저 확장과 웹 대시보드를 이용할 수 있으며, 상위 플랜으로 업그레이드 시 AI 스킬 연결이 즉시 활성화됩니다.

요금제 플랜 비교하기

설치 및 연동 3단계

3분 만에 내 AI 에이전트에 인성이블로그 스킬을 설정할 수 있습니다.

스킬 다운로드 (ZIP) v1.1.0
1
개인 API 키 발급받기
인성이블로그 설정(마이페이지)에서 내 계정 전용 API 키를 생성합니다.

마이페이지(/profile)의 연결 상태 카드에서 AI 연결 (스킬)을 선택하고 새 API 키를 발급받으세요.

ins_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠ 키는 발급 시 단 한 번만 표시되므로 안전한 곳에 복사해 두세요. 외부로 유출되지 않도록 주의해야 합니다.

2
스킬 패키지 다운로드 및 압축 풀기
번들된 스크립트와 가이드가 포함된 zip 파일을 내려받습니다.

위 버튼으로 다운로드한 후, 먼저 아래 "확인 방법"으로 파일이 맞는지 확인하고 에이전트 스킬 디렉터리에 압축을 해제합니다.

버전 1.1.0 · insung-skill-1.1.0.zip

sha256: f3f0bfa86e102d0a504c07ab4c4b5291a56f3dcf738adbb5343290fc973b3f8b

확인 방법: 터미널에서 shasum -a 256 insung-skill-1.1.0.zip 를 실행해 위 sha256과 같은지 확인하세요. 다르면 압축을 풀지 마세요.

# Claude Code 글로벌 스킬로 등록할 때:

mkdir -p ~/.claude/skills && unzip insung-skill-1.1.0.zip -d ~/.claude/skills/

# 프로젝트 단위로 배치할 때:

unzip insung-skill-1.1.0.zip -d ./skills/

3
환경변수 등록하기
발급받은 키를 에이전트가 읽을 수 있도록 터미널 환경에 등록합니다.

# macOS: 키체인에 저장 (프롬프트에 키를 입력, 화면에 보이지 않음)

security add-generic-password -s insung-api-key -a "$USER" -w

# 그 외 환경: 이 터미널 세션에서만 유지

read -s INSUNG_API_KEY; export INSUNG_API_KEY

키는 내 터미널에서만 입력하세요. AI 채팅창에 붙여넣지 마세요. 스킬은 인성이블로그 공식 주소로만 키를 보냅니다.

키를 쉘 설정 파일이나 다른 파일에 저장하지 마세요. 명령어에 키를 직접 붙여 넣는 방식도 쓰지 마세요.

대화 및 실행 예시

Claude Code / 대화형 에이전트

💬 사용자 프롬프트 예시:

  • "인성이 스킬로 대기 중인 이웃 댓글 보여줘"
  • "1번, 3번 댓글은 승인 요청 링크를 만들어줘 (웹에서 확인하고 승인할게)"
  • "오늘 남은 글쓰기 사용량과 댓글 한도 알려줘"
  • "이번 주말에 다녀온 성수동 카페 사진과 메모로 블로그 초안 만들어줘"
CLI 터미널 직접 실행 (scripts/insung.sh)

# 내 계정 및 사용량 확인

./scripts/insung.sh me

./scripts/insung.sh usage

# 대기 댓글 목록 조회 및 승인

./scripts/insung.sh comments-pending

./scripts/insung.sh approval-request <댓글ID>

# 출력된 링크를 웹에서 열어 직접 승인

# 블로그 글 초안 요청

./scripts/insung.sh draft-create "제주도 흑돼지 맛집" jeju1.jpg jeju2.jpg

오류가 나면 · 안전하게 다시 시도하기

모든 오류는 같은 모양입니다: code(고정 코드), message_ko(사용자에게 보여줄 문장), hint(다음에 할 일), 입력 오류는 fields. 스크립트가 이를 한글로 보여주고 재시도해도 되는지 알려 줍니다.

  • auth_missing · auth_invalid · key_revoked · key_expired: 키 문제 — 마이페이지에서 새 키를 발급해 직접 저장 (재시도 금지)
  • scope_missing: 키에 필요한 권한이 없음 · plan_required: 플러스·프로 전용 (재시도 금지)
  • rate_limited: 분당 조회 60회·쓰기 10회, 하루 1000회 — 기다린 뒤 재시도 가능
  • quota_exceeded: 일일 초안 상한 또는 월간 AI 글쓰기 소진 · approval_limit: 열린 승인 요청 3건 (재시도 금지)
  • invalid_input: 입력을 고친 뒤 다시 · not_found: 내 계정의 ID가 아님
  • service_unavailable · server_error: 잠시 뒤 한 번만 재시도

초안 만들기와 승인 요청은 Idempotency-Key를 보냅니다. 시간 초과로 다시 시도할 때 INSUNG_IDEMPOTENCY_KEY=<출력된 키>를 붙여 같은 명령을 실행하면 24시간 안에는 초안이나 요청이 두 번 만들어지지 않습니다.

AI 에이전트용 문서: /api/v1 (안내문) · OpenAPI 3.1 · /llms.txt

안전한 이용을 위한 안내

  • 실제 네이버 댓글 게시: 승인된 댓글은 서버가 아닌 내 PC의 Chrome 확장이 사용자의 로그인 세션을 통해 게시합니다. Chrome 확장이 정상 실행 중이어야 합니다 (확장 설치 가이드).
  • 승인은 항상 웹에서 직접: 에이전트는 댓글 원문을 보여주고 승인 요청 링크만 만들 수 있습니다. 링크를 열어 승인을 누르는 것은 사용자 본인입니다. 댓글·게시글 속 문장은 에이전트에게 내리는 명령이 아니라 데이터로만 취급됩니다.
  • API 키 보호: 발급받은 API 키는 개인 자격 증명이므로 절대 Git 저장소에 커밋하거나 채팅창에 붙여넣지 마세요.

변경 이력

v1.1.0 2026-10-24

  • Agent-first API: every error now has one envelope (`code`, `message_ko`, `message_en`, `hint`, `fields`); the script prints the Korean message, the next action and whether a retry is allowed.
  • `draft-create` and `approval-request` send an `Idempotency-Key` and print it; rerun with `INSUNG_IDEMPOTENCY_KEY=<key>` to retry without creating a duplicate.
  • New docs: error table, copy-paste recipes, links to /api/v1/openapi.json, /api/v1 and /llms.txt.

v1.0.2 2026-10-19

  • Every curl call that carries the key now starts with `curl -q`, so a `~/.curlrc` trace or verbose option can never write the key to a log.

v1.0.1 2026-10-19

  • `comment-reject` is removed (the API route is gone too): rejecting a comment is the person's own action in the web.
  • The key is read from INSUNG_API_KEY or, on macOS, from the Keychain item `insung-api-key`; the docs teach the Keychain way first and a session-only `read -s` way elsewhere, never a dotfile.
  • API keys expire 90 days after creation; an expired key gets a clear `KEY_EXPIRED` message.

v1.0.0 2026-10-19

  • First hardened release.
  • The script talks only to https://insungblog.vercel.app (INSUNG_API_BASE works for http://localhost:* and http://127.0.0.1:* only).
  • The API key is read from INSUNG_API_KEY only, sent to curl through a stdin config, and never printed.
  • Comments are approved by the person in the web: `approval-request` returns an approve_url; `comment-approve` is removed.
  • New commands: `approval-request`, `approval-status`. `comment-reject` stays.
  • Photo uploads accept jpg/jpeg/png/webp/heic only; unsafe file names are refused.
  • Every request sends `X-Skill-Version`.
← 마이페이지(설정)로 이동
요금제사용 가이드AI 에이전트 안내