> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jinba.io/llms.txt
> Use this file to discover all available pages before exploring further.

# X (Twitter)

> X API を使ってポスト投稿、ユーザープロフィール取得、ツイート検索を行う

## 概要

X（Twitter）ツールを使用すると、X プラットフォームの API を介してポストの投稿、ユーザープロフィールの取得、ツイートの検索、特定のツイート情報の取得など、包括的なソーシャルメディア統合機能を提供します。

## 主な機能

* `X_POST`: 自分の X アカウントにポストを投稿
* `X_GET_USER_PROFILE`: ユーザープロフィール情報を取得
* `X_SEARCH_TWEETS`: クエリを使ってツイートを検索
* `X_GET_TWEETS`: ID や条件で特定のツイートを取得

## 認証

X API を使用するには、[X Developer Platform](https://developer.x.com/) にて開発者アカウントを作成し、API キーを発行する必要があります。

* `X_POST` は OAuth 1.0a のユーザーコンテキスト認証情報（config）を使用します：`consumer_key`、`consumer_secret`、`access_token`、`access_token_secret`
* `X_GET_USER_PROFILE`、`X_SEARCH_TWEETS`、`X_GET_TWEETS` はアプリ専用 OAuth 2.0 の Bearer トークン（config）を使用します：`bearer_token`

**注意**：API キーは機密情報として扱い、公開リポジトリにコミットしないでください。

## ツール

### X\_POST

X アカウントにポストを投稿します。

**入力**:

| パラメータ        | 型      | 必須 | 説明        |
| ------------ | ------ | -- | --------- |
| `tweet_text` | string | はい | ポストするテキスト |

**出力**:

| フィールド        | 型      | 説明            |
| ------------ | ------ | ------------- |
| `tweet.id`   | string | 投稿されたポストのID   |
| `tweet.text` | string | 投稿されたポストのテキスト |

### X\_GET\_USER\_PROFILE

X からユーザープロフィール情報を取得します。

**入力**:

* `username`（string、必須）: 検索するユーザー名（@マーク不要）

**出力**:

`id`、`username`、`name` に加え、取得可能な場合は `description`、`location`、`url`、`verified`、`followers_count`、`following_count`、`tweet_count`、`created_at`、`profile_image_url` を含む `user` オブジェクト。

### X\_SEARCH\_TWEETS

特定のクエリを使ってツイートを検索します。

**入力**:

| パラメータ              | 型       | 必須  | 説明                                                 |
| ------------------ | ------- | --- | -------------------------------------------------- |
| `query`            | string  | はい  | 検索クエリ                                              |
| `count`            | number  | いいえ | 取得するツイート数（1〜100、デフォルト: 10）                         |
| `result_type`      | string  | いいえ | 結果タイプ: `recent`、`popular`、`mixed`（デフォルト: `recent`） |
| `include_entities` | boolean | いいえ | ハッシュタグ・メンション・URL などのエンティティを含める（デフォルト: `false`）     |

**出力**:

`tweets` 配列。各ツイートは `id`、`text`、`created_at`、`author` に加え、任意で `public_metrics`（`retweet_count`、`like_count`、`reply_count`）と `entities`（`hashtags`、`mentions`、`urls`）を含みます。

### X\_GET\_TWEETS

指定したユーザーのタイムラインから最近のツイートを取得します。

**入力**:

| パラメータ              | 型       | 必須  | 説明                          |
| ------------------ | ------- | --- | --------------------------- |
| `username`         | string  | はい  | ユーザー名（@マーク不要）               |
| `count`            | number  | いいえ | 取得するツイート数（1〜100、デフォルト: 10）  |
| `include_replies`  | boolean | いいえ | 返信を結果に含める（デフォルト: `false`）   |
| `include_retweets` | boolean | いいえ | リポストを結果に含める（デフォルト: `false`） |

**出力**:

`tweets` 配列。各ツイートは `id`、`text`、`created_at`、`author`（`username`、`name`）に加え、任意で `public_metrics`（`retweet_count`、`like_count`、`reply_count`）を含みます。

## 使用例

### 例：ポストを投稿する

```yaml theme={null}
- id: post_tweet
  tool: X_POST
  config:
    - name: consumer_key
      value: "{{secrets.TWITTER_CONSUMER_KEY}}"
    - name: consumer_secret
      value: "{{secrets.TWITTER_CONSUMER_SECRET}}"
    - name: access_token
      value: "{{secrets.TWITTER_ACCESS_TOKEN}}"
    - name: access_token_secret
      value: "{{secrets.TWITTER_ACCESS_TOKEN_SECRET}}"
  input:
    - name: tweet_text
      value: "Jinba Flow からこんにちは！🚀"
```

### 例：ユーザープロフィールを取得する

```yaml theme={null}
- id: get_profile
  tool: X_GET_USER_PROFILE
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: username
      value: "jinbaflow_JP"
```

### 例：ツイートを検索する

```yaml theme={null}
- id: search_tweets
  tool: X_SEARCH_TWEETS
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: query
      value: "ワークフロー自動化"
    - name: count
      value: 20
```

### 例：ユーザーのツイートを取得する

```yaml theme={null}
- id: get_tweets
  tool: X_GET_TWEETS
  config:
    - name: bearer_token
      value: "{{secrets.TWITTER_BEARER_TOKEN}}"
  input:
    - name: username
      value: "jinbaflow_JP"
    - name: count
      value: 10
    - name: include_retweets
      value: false
```

## 用途

* ソーシャルメディアの自動化とスケジューリング
* ソーシャルリスニングとブランド監視
* 顧客エンゲージメントとサポート
* コンテンツ拡散とマーケティング
* リアルタイムトレンド分析
* コミュニティ管理