블로그 초안 생성을 시작합니다 (백그라운드 실행).

입력 유형 (input_type)

• keyword: 키워드/주제로 글 생성

• code: 코드 스니펫을 설명하는 글 생성

• memo: 메모/노트를 완성된 글로 확장

• git_push: git 변경사항으로 개발일지 생성

• notion: Notion 페이지 URL을 입력하면 내용을 자동으로 가져와서 블로그 글 생성 (content에 Notion URL 입력, notion_api_key 필요)

글 스타일 (style)

• tutorial: 단계별 튜토리얼 (기본값)

• til: Today I Learned 형식

• deep-dive: 심층 기술 분석

• troubleshooting: 문제 해결 과정

모델 선택 (model)

• gemini-1.5-flash: 빠른 응답, 일반 용도 (기본값)

• gemini-1.5-flash-8b: 더 빠른 응답, 간단한 작업

• gemini-1.5-pro: 고품질, 복잡한 작업

• gemini-2.0-flash: 최신 모델

상세 지침 (instructions / instructions_file)

skill.md 스타일로 상세한 작성 지침을 제공할 수 있습니다:

• 글의 톤과 문체

• 반드시 포함할 섹션

• 타겟 독자층

• 예시 스타일 참조

• 금지 표현

• 코드 스타일 가이드 등을 상세히 기술하면 모델이 지침을 따릅니다.

instructions_file로 마크다운 파일 경로를 지정하면 파일에서 지침을 읽어옵니다. 둘 다 제공하면 파일 내용 + 파라미터 내용이 병합됩니다.

Args:

• input_type: 입력 유형

• content: 블로그 글 생성에 사용할 입력 내용

• style: 글 스타일 (기본: tutorial)

• language: 출력 언어 ko/en (기본: ko)

• model: Gemini 모델 (기본: gemini-1.5-flash)

• instructions: 상세 작성 지침 (선택)

• instructions_file: 상세 작성 지침 마크다운 파일 경로 (선택)

• custom_prompt: 간단한 추가 요청 (선택)

• gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

• notion_api_key: Notion API 키 (input_type이 notion일 때 필요, 없으면 NOTION_API_KEY 환경변수 사용)

• web_search: 웹 검색 활용 여부 (기본: false). true로 설정하면 최신 정보, 통계, 참고 자료를 웹에서 검색하여 포함

Returns:

• task_id: 작업 추적용 ID

• status: "pending"

• message: 안내 메시지

작업 상태를 조회합니다.

Args:

• task_id: 조회할 작업 ID

Returns:

• task_id: 작업 ID

• status: pending | in_progress | completed | failed

• progress: 진행률 (0-100)

• result: 완료 시 결과 (draft, metadata 등)

• error: 실패 시 오류 메시지

사용자 피드백을 초안에 반영합니다 (백그라운드 실행).

피드백 히스토리가 저장되어 이전 피드백들을 추적할 수 있습니다.

모델 선택 (model)

• gemini-1.5-flash: 빠른 응답 (기본값)

• gemini-1.5-pro: 고품질 피드백 반영

Args:

• task_id: 피드백을 적용할 작업 ID

• feedback: 수정 요청 사항

• model: Gemini 모델 (기본: gemini-1.5-flash)

• gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

Returns:

• task_id: 작업 ID

• status: "pending"

• message: 안내 메시지

블로그 초안을 확정합니다.

완료된 작업의 최종 결과를 반환합니다. 이후 blog_save 또는 blog_deploy_github로 저장/배포할 수 있습니다.

Args:

• task_id: 확정할 작업 ID

Returns:

• draft: 최종 확정된 초안

• metadata: { title, tags, estimatedReadTime }

• message: 안내 메시지

블로그 글 검수를 시작합니다 (백그라운드 실행).

기존 작업 ID를 사용하거나 직접 초안을 입력할 수 있습니다.

검수 초점 (focus)

• accuracy: 기술적 정확성

• readability: 가독성

• seo: SEO 최적화

• all: 전체 검수 (기본값)

모델 선택 (model)

• gemini-1.5-flash: 빠른 검수 (기본값)

• gemini-1.5-pro: 심층 검수

상세 검수 지침 (instructions / instructions_file)

검수 기준을 상세히 지정할 수 있습니다:

• 회사/팀 스타일 가이드

• 용어 사용 규칙

• 코드 컨벤션

• 타겟 독자 수준

• 금지 표현 등을 명시하면 해당 기준으로 검수합니다.

instructions_file로 마크다운 파일 경로를 지정하면 파일에서 지침을 읽어옵니다. 둘 다 제공하면 파일 내용 + 파라미터 내용이 병합됩니다.

Args:

• task_id: 기존 작업 ID (선택)

• draft: 직접 입력할 초안 내용 (선택)

• focus: 검수 초점 (기본: all)

• model: Gemini 모델 (기본: gemini-1.5-flash)

• instructions: 상세 검수 지침 (선택)

• instructions_file: 상세 검수 지침 마크다운 파일 경로 (선택)

• custom_prompt: 간단한 추가 검수 요청 (선택)

• gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

Returns:

• task_id: 검수 작업 ID

• status: "pending"

• message: 안내 메시지

검수 결과에 추가 피드백을 반영합니다 (백그라운드 실행).

모델 선택 (model)

• gemini-1.5-flash: 빠른 응답 (기본값)

• gemini-1.5-pro: 고품질 피드백 반영

Args:

• task_id: 피드백을 적용할 검수 작업 ID

• feedback: 추가 검수 요청 사항

• model: Gemini 모델 (기본: gemini-1.5-flash)

• gemini_api_key: Gemini API 키 (없으면 GEMINI_API_KEY 환경변수 사용)

Returns:

• task_id: 작업 ID

• status: "pending"

• message: 안내 메시지

블로그 글을 로컬 마크다운 파일로 저장합니다.

기존 작업 ID를 사용하거나 직접 콘텐츠를 입력할 수 있습니다. 파일명이 제공되지 않으면 글 제목과 날짜를 기반으로 자동 생성합니다.

Args:

• task_id: 저장할 작업 ID (선택)

• content: 직접 저장할 마크다운 콘텐츠 (선택)

• filename: 파일명 (선택, 없으면 자동 생성)

• directory: 저장 디렉토리 경로 (없으면 BLOG_SAVE_DIRECTORY 환경변수 또는 ./posts)

Returns:

• filepath: 저장된 파일의 전체 경로

• message: 안내 메시지

블로그 글을 GitHub 저장소에 배포합니다.

기존 작업 ID, 직접 콘텐츠 입력, 또는 로컬 파일 경로를 사용할 수 있습니다. Jekyll, Hugo 등의 정적 사이트 생성기를 사용하는 블로그에 직접 커밋합니다.

Args:

• task_id: 배포할 작업 ID (선택)

• content: 직접 배포할 마크다운 콘텐츠 (선택)

• filepath: 배포할 로컬 파일 경로 (선택)

• repo: GitHub 저장소 (owner/repo 형식, 필수)

• branch: 배포할 브랜치 (기본: main)

• target_path: 저장소 내 저장 경로 (필수)

• commit_message: 커밋 메시지 (선택)

• github_token: GitHub Personal Access Token (필수)

Returns:

• url: 커밋 URL

• deployed: 배포 성공 여부

• message: 안내 메시지

[HTTP 모드 전용] Claude Opus(분석 + 작성) 파이프라인으로 고품질 블로그 생성을 시작합니다.

⚠️ Claude Desktop/Code 사용자: 이 도구는 HTTP 모드에서만 필요합니다. Claude Desktop/Code 환경에서는 Claude에게 직접 "이 코드로 블로그 써줘"라고 요청하세요. Claude가 직접 코드를 분석하고 블로그를 작성합니다.

작동 방식 (HTTP 모드)

1. Claude Opus가 코드를 분석하여 인사이트 추출

2. Claude Opus가 분석 결과를 바탕으로 블로그 작성

3. blog_get_status로 완료 확인

Args:

• code_diff: Git diff 또는 변경된 코드 (필수)

• dev_log: 개발자의 고민/메모/의사결정 과정 (선택)

• request: 최우선 제약조건 (선택)

• style: 글 스타일 (기본: deep-dive)

• language: 언어 (기본: ko)

• instructions: 상세 작성 지침 (선택)

• instructions_file: 상세 작성 지침 마크다운 파일 경로 (선택, instructions와 병합 가능)

• anthropic_api_key: Anthropic API 키 (환경변수로 대체 가능)

• web_search: 웹 검색 활용 여부 (기본: true). 최신 정보, 이미지, 참고 자료를 웹에서 검색하여 포함

Returns:

• task_id: 작업 추적용 ID

• status: 작업 상태

[HTTP 모드 전용] Pro Mode로 생성된 블로그 초안에 피드백을 반영합니다.

⚠️ Claude Desktop/Code 사용자: 이 도구는 HTTP 모드에서만 필요합니다. Claude Desktop/Code 환경에서는 Claude에게 직접 수정을 요청하세요.

Args:

• task_id: Pro 작업 ID (필수)

• feedback: 수정 요청 사항 (필수)

• anthropic_api_key: Anthropic API 키 (환경변수로 대체 가능)

Returns:

• task_id: 작업 ID

• status: 작업 상태