前へ次へ

Python APIサーバー構築

25分⭐⭐⭐☆☆

このモジュールの最後にスクリプトダウンロードがあります。

このモジュールで学ぶこと

  • Python環境の確認とライブラリインストール
  • X投稿用APIサーバーの構築
  • サーバーの起動とテスト

学習目標

このモジュールを終えると、以下のことができるようになります：

  1. tweepyとflaskをインストールできる
  2. X投稿用のAPIサーバーを起動できる
  3. サーバーが正常に動作することを確認できる

目次

事前準備

必要なもの

  • Python 3.8以上
  • pip（Pythonパッケージマネージャー）
  • Module 02で取得した4つのAPIキー

APIキーの確認

以下の4つのキーが手元にあることを確認してください。

キー用途
API Keyアプリ識別子
API Secretアプリ秘密鍵
Access Tokenユーザートークン
Access Token Secretユーザー秘密鍵

セクション1: Python環境の確認

1-1. Pythonバージョン確認

PowerShellを開いて以下を実行します。

python --version

期待される出力:

Python 3.10.9

Python 3.8以上であればOKです。

1-2. pipバージョン確認

pip --version

期待される出力:

pip 24.2 from C:\Users\...\pip (python 3.10)

チェックポイント

  • Python 3.8以上がインストールされている
  • pipが使用できる

セクション2: ライブラリのインストール

2-1. tweepyのインストール

tweepyはX API v2を簡単に使うためのライブラリです。

pip install tweepy

期待される出力:

Successfully installed tweepy-4.16.0

2-2. flaskのインストール

flaskはAPIサーバーを作成するためのライブラリです。

pip install flask

期待される出力:

Successfully installed flask-x.x.x

（既にインストール済みの場合は「Requirement already satisfied」と表示されます）

2-3. python-dotenvのインストール

python-dotenvは.envファイルから環境変数を読み込むためのライブラリです。

pip install python-dotenv

2-4. インストール確認

pip show tweepy

pip show flask

それぞれバージョン情報が表示されればOKです。

チェックポイント

  • tweepyがインストールされた
  • flaskがインストールされた
  • python-dotenvがインストールされた

セクション3: APIサーバースクリプトの作成

3-1. スクリプト保存用フォルダの作成

任意の場所にフォルダを作成します（例: C:\scripts）。

mkdir C:\scripts

3-2. .envファイルの作成

C:\scripts\.env を作成し、Module 02で取得した認証情報を入力します。

X_API_KEY=あなたのAPI_KEY
X_API_SECRET=あなたのAPI_SECRET
X_ACCESS_TOKEN=あなたのACCESS_TOKEN
X_ACCESS_TOKEN_SECRET=あなたのACCESS_TOKEN_SECRET

3-3. スクリプトファイルの作成

以下の内容で C:\scripts\x_api_server.py を作成します。

from flask import Flask, request, jsonify
import tweepy
import os
from dotenv import load_dotenv

# .envファイルから環境変数を読み込み
load_dotenv()

app = Flask(__name__)

# ====== 環境変数から認証情報を取得 ======
API_KEY = os.getenv("X_API_KEY")
API_SECRET = os.getenv("X_API_SECRET")
ACCESS_TOKEN = os.getenv("X_ACCESS_TOKEN")
ACCESS_TOKEN_SECRET = os.getenv("X_ACCESS_TOKEN_SECRET")
# ========================================

# Twitterクライアント
client = tweepy.Client(
    consumer_key=API_KEY,
    consumer_secret=API_SECRET,
    access_token=ACCESS_TOKEN,
    access_token_secret=ACCESS_TOKEN_SECRET
)

@app.route('/post', methods=['POST'])
def post_tweet():
    try:
        data = request.get_json()
        text = data.get('text', '')

        if not text:
            return jsonify({'error': 'text is required'}), 400

        response = client.create_tweet(text=text)
        tweet_id = response.data['id']

        return jsonify({
            'success': True,
            'tweet_id': tweet_id,
            'text': text
        })
    except Exception as e:
        return jsonify({'error': str(e)}), 500

@app.route('/health', methods=['GET'])
def health():
    return jsonify({'status': 'ok'})

if __name__ == '__main__':
    print("X API Server starting on http://localhost:5000")
    app.run(host='0.0.0.0', port=5000)

重要な注意事項

  • .envファイルは絶対にGitHubなどに公開しないでください
  • .gitignoreに.envを追加してください

チェックポイント

  • .envファイルを作成した
  • スクリプトファイルを作成した
  • 4つのAPIキーを.envに入力した

セクション4: サーバーの起動とテスト

4-1. サーバーの起動

PowerShellで以下を実行します。

python C:\scripts\x_api_server.py

期待される出力:

X API Server starting on http://localhost:5000
 * Serving Flask app 'x_api_server'
 * Debug mode: off
 * Running on all addresses (0.0.0.0)
 * Running on http://127.0.0.1:5000
 * Running on http://192.168.x.x:5000
Press CTRL+C to quit

4-2. ヘルスチェック

別のPowerShellウィンドウを開いて、以下を実行します。

curl http://localhost:5000/health

期待される出力:

{"status":"ok"}

4-3. テスト投稿（任意）

curlでテスト投稿ができます。

curl -X POST http://localhost:5000/post -H "Content-Type: application/json" -d "{\"text\":\"APIサーバーからのテスト投稿\"}"

期待される出力:

{"success":true,"tweet_id":"123456789...","text":"APIサーバーからのテスト投稿"}

4-4. サーバーの停止

サーバーを停止するには、PowerShellで Ctrl+C を押します。

チェックポイント

  • サーバーが起動した
  • ヘルスチェックで {"status":"ok"} が返ってきた

トラブルシューティング

ModuleNotFoundError: No module named 'tweepy'

原因: tweepyがインストールされていない

解決策:

pip install tweepy

403 Forbidden エラー

原因: App permissionsが「Read」のみになっている

解決策:

  1. X Developer Portalで「Read and write」に変更
  2. Access Tokenを再生成
  3. スクリプト内のトークンを更新
  4. サーバーを再起動

Address already in use

原因: ポート5000が既に使用されている

解決策:

app.run(host='0.0.0.0', port=5001)  # ポート番号を変更

まとめ

このモジュールで学んだこと

  • tweepyとflaskのインストール方法
  • X投稿用APIサーバーの構築方法
  • サーバーの起動とテスト方法

APIエンドポイント

エンドポイントメソッド用途
/healthGETサーバー状態確認
/postPOSTツイート投稿

次のステップ

Module 04では、n8nからこのAPIサーバーを呼び出すワークフローを構築します。

スクリプトダウンロード

以下のスクリプトをダウンロードして使用できます。

x_api_server.py

ダウンロード後に必要な設定:

スクリプトと同じディレクトリに.envファイルを作成し、以下の内容を設定してください。

X_API_KEY=あなたのAPI_KEY
X_API_SECRET=あなたのAPI_SECRET
X_ACCESS_TOKEN=あなたのACCESS_TOKEN
X_ACCESS_TOKEN_SECRET=あなたのACCESS_TOKEN_SECRET
環境変数取得場所
X_API_KEYX Developer Portal → Keys and tokens
X_API_SECRETX Developer Portal → Keys and tokens
X_ACCESS_TOKENX Developer Portal → Keys and tokens
X_ACCESS_TOKEN_SECRETX Developer Portal → Keys and tokens

参考資料

よくある質問

Q: サーバーをバックグラウンドで実行できますか？ A: Windowsの場合、タスクスケジューラでスタートアップ時に実行するか、pythonwコマンドを使用します。

Q: ポート番号を変更できますか？ A: はい、スクリプト内の app.run(host='0.0.0.0', port=5000) のポート番号を変更してください。

Q: 複数のアカウントで投稿したい場合は？ A: 別のポートで別のAPIサーバーを起動し、それぞれに異なるAPIキーを設定します。

Q: .envファイルが読み込まれません A: .envファイルがスクリプトと同じディレクトリにあることを確認してください。また、python-dotenvがインストールされているか確認してください。

Q: サーバーが落ちたらどうなりますか？ A: n8nからのリクエストがエラーになります。本番運用ではsupervisordなどでプロセス監視することを推奨します。

前へ次へ
運営: ゆめスタ