---
title: X
description: Xとインタラクトする
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="x"
  color="#000000"
/>

{/* MANUAL-CONTENT-START:intro */}
[X](https://x.com/)（旧Twitter）は、リアルタイムコミュニケーション、コンテンツ共有、世界中のオーディエンスとのエンゲージメントを可能にする人気のソーシャルメディアプラットフォームです。

SimにおけるX統合は、OAuth認証を活用してXのAPIと安全に接続し、エージェントがプログラムによってプラットフォームとやり取りできるようにします。このOAuth実装により、ユーザーのプライバシーとセキュリティを維持しながら、Xの機能への安全なアクセスが保証されます。

X統合により、エージェントは以下のことが可能になります：

- **コンテンツの投稿**: ワークフローから直接新しいツイートの作成、既存の会話への返信、またはメディアの共有
- **会話のモニタリング**: 関連する議論について情報を得るために、メンション、キーワード、または特定のアカウントを追跡
- **オーディエンスとのエンゲージメント**: メンション、ダイレクトメッセージ、または特定のトリガーに自動的に応答
- **トレンド分析**: トレンドトピック、ハッシュタグ、またはユーザーエンゲージメントパターンから洞察を収集
- **情報調査**: エージェントの意思決定に役立つ特定のコンテンツ、ユーザープロファイル、または会話を検索

Simでは、X統合により高度なソーシャルメディア自動化シナリオが可能になります。エージェントはブランドメンションをモニタリングして適切に対応したり、特定のトリガーに基づいてコンテンツをスケジュールして公開したり、市場調査のためのソーシャルリスニングを実施したり、会話型AIとソーシャルメディアエンゲージメントの両方にまたがるインタラクティブな体験を作成したりすることができます。SimとXをOAuthで接続することで、プラットフォームのポリシーとAPI使用のベストプラクティスを遵守しながら、一貫性のある応答性の高いソーシャルメディアプレゼンスを維持するインテリジェントなエージェントを構築できます。
{/* MANUAL-CONTENT-END */}

## 使用方法

Xをワークフローに統合します。新しいツイートの投稿、ツイートの詳細取得、ツイート検索、ユーザープロフィールの取得が可能です。OAuthが必要です。

## ツール

### `x_write`

X（Twitter）で新しいツイートの投稿、ツイートへの返信、または投票の作成を行います

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `text` | string | はい | ツイートのテキスト内容 |
| `replyTo` | string | いいえ | 返信先ツイートのID |
| `mediaIds` | array | いいえ | ツイートに添付するメディアIDの配列 |
| `poll` | object | いいえ | ツイートの投票設定 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tweet` | object | 新しく作成されたツイートデータ |

### `x_read`

返信や会話のコンテキストを含むツイートの詳細を読み取ります

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `tweetId` | string | はい | 読み取るツイートのID |
| `includeReplies` | boolean | いいえ | ツイートへの返信を含めるかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tweet` | object | メインツイートデータ |

### `x_search`

キーワード、ハッシュタグ、または高度なクエリを使用してツイートを検索します

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `query` | string | はい | 検索クエリ（X検索演算子をサポート） |
| `maxResults` | number | いいえ | 返す結果の最大数（デフォルト：10、最大：100） |
| `startTime` | string | いいえ | 検索の開始時間（ISO 8601形式） |
| `endTime` | string | いいえ | 検索の終了時間（ISO 8601形式） |
| `sortOrder` | string | いいえ | 結果の並べ替え順序（recencyまたはrelevancy） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `tweets` | array | 検索クエリに一致するツイートの配列 |

### `x_user`

ユーザープロフィール情報を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `username` | string | はい | 検索するユーザー名（@記号なし） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `user` | object | Xユーザープロフィール情報 |
