기획부터 포스팅까지 자동화: Zenn(GitHub 연동)과 Qiita(API v2)를 하나의 리포지토리에서 운영하는 방법

[기획] loop/queue.md (후보 및 상태)
|
[집필] articles/<slug>.md (본문 + frontmatter)
...

.
├─ AGENTS.md # AI 에이전트를 위한 운영 규칙
├─ articles/ # 기사. 여기가 유일한 원본입니다.
...

---
title: 

또한 `loop/queue.md`에 기획 후보와 상태(후보 / 집필 중 / 공개됨 등)를 저장하고 있습니다. AI 세션은 매번 깨끗하기 때문에, **큐와 공개 로그를 리포지토리에 보관**함으로써 다음에 어떤 세션부터 재개하더라도 동일한 루프를 계속할 수 있습니다.

note는 개인용 포스팅 API가 없습니다(note pro용 'note API'는 제휴 서비스의 초안 저장에 한정됩니다). 게다가 2026년 2월에는 기계적인 대량 포스팅이나 외부 서비스를 이용한 자동화에 대한 대응 강화가 공식 발표되었으며, '위반 시 사전 통지 없이 이용이 정지될 수 있으며, 통지 의무를 지지 않는다'는 내용도 약관에 명시되어 있습니다.

'약관상 특정 언급이 없으면 괜찮다'라고 해석하는 것은 판단의 여지가 모두 운영 측에 있다는 의미이므로, 이쪽(사용자)에게 유리한 자료가 될 수 없다는 것이 조사 후 내린 결론이었습니다.

X API는 2026년 2월부터 종량제(従量課金制)로 전환되며, 신규 계정은 최초 $5의 충전 없이 포스팅할 수 없습니다(포스팅당 $0.01). 따라서 기사 게시처로는 주축에서 제외하고, 공지용으로 나중에 추가하거나 검토하는 중입니다.

Zenn은 push 이후 Zenn 측에서 배포가 실행됩니다. 성공 여부는 대시보드의 배포 이력에서 확인할 수 있으므로, 여기는 사람의 눈(또는 스크린샷을 찍는 메커니즘)이 필요한 지점입니다. 반대로 말하면, 그 외의 과정은 전부 명령어로 완료됩니다.

- 게시처는 **공식적인 수단이 있는 곳** (Zenn = GitHub 연동, Qiita = API v2)을 선택하는 것이 약관 리스크를 피하면서 push와 API만으로 자동 포스팅을 돌릴 수 있습니다. 기사 파일을 하나로 만들고 미디어별 차이점(태그 표시명)만 코드로 흡수하면, 복사 붙여넣기 없이 양쪽 매체에 게시할 수 있습니다.
- 자동화 자체보다는 **'검증을 강제하는 AGENTS.md'와 '기획 큐'**가 AI와 함께 하는 기사 운영에서는 더 효과적입니다.

Zenn도 Qiita도 무료 플랜만으로 구성되어 있으므로, 같은 형태는 그대로 따라 할 수 있습니다. 이 구성이 누군가의 참고가 되기를 바랍니다.