はじめに

こんにちは、piyovateです。

この記事では、Qiita CLIとGitHub Actionsを使って、GitHubにpushするだけで自動的にQiitaに記事を投稿する環境を0から構築します 🚀

「記事をローカルで管理したい」「バージョン管理したい」「自動投稿したい」という方におすすめです 💪

🎯 この記事でできるようになること

Qiita CLIで作成した記事をGitHubで安全に管理できる
GitHubにpushするだけで自動的にQiitaに投稿される
公式のシンプルな方法で確実に動作する環境を構築できる

🧭 前提環境

ツール	バージョン例
Node.js	20.x 以上
npm	10.x 以上
Qiita CLI	最新版
GitHub Actions	Ubuntu Runner 最新版

📝 Step 1：新しいプロジェクトを作成

まずは、クリーンな環境で始めましょう。

# 作業ディレクトリを作成
mkdir qiita-posts-official
cd qiita-posts-official

# Qiita CLIで初期化
npx qiita init

実行すると以下のファイルが自動生成されます：

qiita-posts-official/
├── .github/
│   └── workflows/
│       └── publish.yml    # ← GitHub Actionsのワークフロー
├── .gitignore
└── qiita.config.json

🔑 Step 2：Qiitaにログイン

npx qiita login

ブラウザで以下のURLが表示されるので、アクセスしてトークンを発行：
https://qiita.com/settings/tokens/new?read_qiita=1&write_qiita=1

発行したトークンを入力すると、ログイン完了です 🎉

📰 Step 3：テスト記事を作成

npx qiita new test-article

生成された test-article.md を編集：

---
title: GitHub Actionsでの自動投稿テスト
tags:
  - test
private: false
updated_at: ''
id: null
organization_url_name: null
slide: false
ignorePublish: false
---

これはGitHub Actionsのテストです 🚀

🐙 Step 4：GitHubリポジトリを作成

🔐 Step 5：QIITA_TOKENをSecretsに登録

これが最重要ステップです！

作成したリポジトリページで Settings タブをクリック
左メニューから Secrets and variables → Actions をクリック
New repository secret をクリック
以下を入力：
- Name: QIITA_TOKEN
- Secret: Step 2で発行したトークンを貼り付け
Add secret をクリック

⚠️ 重要: トークンは絶対にコードにコミットしないでください！

📤 Step 6：Gitの初期設定とプッシュ

# Gitリポジトリを初期化
git init

# ユーザー設定（未設定の場合）
git config user.name "your-name"
git config user.email "your-email@example.com"

# すべてのファイルを追加
git add .

# 初回コミット
git commit -m "Initial commit: Qiita CLI setup"

# ブランチ名をmainに
git branch -M main

# リモートリポジトリを追加
git remote add origin https://github.com/your-username/qiita-posts-official.git

# プッシュ
git push -u origin main

🎬 Step 7：GitHub Actionsの動作確認

プッシュすると、自動的にGitHub Actionsが実行されます。

GitHubのリポジトリページで Actions タブをクリック
「Publish articles」ワークフローが実行中/完了を確認
✅ 成功すると、Qiitaに記事が投稿されます

🚀 使い方：記事を投稿する

新規記事を投稿

# 記事を作成
npx qiita new my-awesome-article

# 内容を編集
notepad my-awesome-article.md

# Git管理
git add .
git commit -m "Add new article"
git push

→ GitHub Actionsが自動実行され、Qiitaに投稿されます 🎉

既存記事を更新

# 記事を編集
notepad existing-article.md

# Git管理
git add .
git commit -m "Update article"
git push

→ GitHub Actionsが自動実行され、Qiitaの記事が更新されます 🎉

🎓 まとめ

この記事では、公式のQiita CLIとGitHub Actionを使った、シンプルで確実な自動投稿環境を構築しました。

できるようになったこと

✅ GitHubにpushするだけで自動的にQiitaに投稿
✅ 記事のバージョン管理
✅ 複雑なスクリプトなしで確実に動作

📚 参考リンク

🙌 おわりに

この記事が役に立ったら、いいねをお願いします 👍

次回は投稿予約の設定を行いたいと思います

次回もお楽しみに！