Paperclip

Paperclip エージェント向け TwexAPI Paperclip プラグインをインストールし、ツイート検索、プロフィール、タイムライン、トレンドツイートを利用する。

TwexAPI Paperclip プラグインは Paperclip エージェントに6つの読み取り専用 Twitter/X ツールを追加します。ドキュメント化された TwexAPI REST ルートを型付きツールスキーマ、シークレットバック認証、予測可能な JSON 結果でラップします。

Paperclip エージェントが生 HTTP 呼び出しなしでツイート検索、プロフィール参照、ユーザー検索、タイムライン読み取り、グローバルトレンドツイートを必要とする場合にこのプラグインを使用してください。

ツール

Agent task	Paperclip tool	TwexAPI route
ツイート検索	`twexapi.search_tweets`	`POST /twitter/advanced_search/page`
1件のツイート読み取り	`twexapi.lookup_tweet`	`POST /v2/tweet/detail`
ユーザー検索	`twexapi.search_users`	`GET /twitter/search-user/{keyword}/{target_count}`
プロフィール読み取り	`twexapi.get_user`	`GET /twitter/{screen_name}/about`
プロフィールツイート読み取り	`twexapi.get_user_tweets`	`POST /twitter/{screen_name}/timeline/page`
トレンドツイート読み取り	`twexapi.get_trends`	`GET /twitter/global-trending/tweets`

このプラグインはフォロワーエクスポートや投稿公開は行いません。それらのタスクには REST API、CLI、または MCP Server を使用してください。

前提条件

Node.js 18 以降
Paperclip CLI（paperclipai）
ダッシュボードから取得した TwexAPI API キー
API キー用の Paperclip シークレット参照

インストール

paperclipai plugin install @twexapi-dev/paperclip-plugin-x-api-scraper

再現可能なインストールが必要な場合は現在のリリースをピン留めします。

paperclipai plugin install @twexapi-dev/paperclip-plugin-x-api-scraper --version 0.1.2

npm: @twexapi-dev/paperclip-plugin-x-api-scraper

ソース: twexapi-dev/paperclip-plugin-x-api-scraper

設定

TwexAPI ダッシュボードで API キーを作成します。Paperclip シークレットに保存し、プラグイン設定から参照します。

設定項目	用途
`apiBaseUrl`	TwexAPI REST エンドポイント。デフォルト `https://api.twexapi.io`。
`apiKeySecretRef`	TwexAPI API キー用 Paperclip シークレット参照。
`defaultTimelineCount`	デフォルトタイムラインページ数（1〜100）。
`defaultUserSearchCount`	デフォルトユーザー検索数（1〜100）。
`defaultTrendCount`	デフォルトトレンド数（1〜100）。

Paperclip は呼び出し時に API キーを解決し、Authorization: Bearer を送信します。

プラグイン設定例:

{
  "apiBaseUrl": "https://api.twexapi.io",
  "apiKeySecretRef": "twexapi/api-key",
  "defaultTimelineCount": 20,
  "defaultUserSearchCount": 10,
  "defaultTrendCount": 20
}

ソース管理にチェックインするプラグイン設定ファイルに API キーをコミットしないでください。

エージェントタスク例

ツイート検索

エージェントにトピックに関する最近の投稿を検索させます。プラグインは twexapi.search_tweets 経由で POST /twitter/advanced_search/page を呼び出します。

推奨プロンプト:

Search X for recent posts about "AI agents lang:en -filter:retweets".
Return tweet IDs, author usernames, text, and created_at for the top 10 results.

プロフィールとタイムラインの読み取り

Look up @openai, then read the latest timeline page.
Return username, user_id, follower count, and the 5 most recent tweet IDs.

グローバルトレンドツイートの読み取り

Get trending tweets for United States, topic Sports, content NFL.
Summarize the top themes and list 5 representative tweet IDs.

ハンドオフチェックリスト

Paperclip エージェントが結果を下流システムに渡す場合、安定識別子を保持してください。

Data type	Store
ツイート	`tweet_id`, `text`, `author_username`, `created_at`, 検索クエリ
プロフィール	`user_id`, `username`, `name`, フォロワー数
トレンド	国、トピック、コンテンツタグ、ツイート行
ページネーション	`next_cursor`, `has_more`, 元のリクエストパラメータ

同一ワークフローで Paperclip ツールと MCP ベースエージェントを混在させる場合は Agent MCP Handoff を参照してください。

エラー処理

ステータス	対処法
`400`	ツール入力を修正。変更なしでリトライしない。
`401`	Paperclip シークレット参照と API キー値を確認。
`403`	アカウントアクセスとクレジットを確認。
`429`	リトライ前にバックオフ。
`5xx`	上限付きバックオフでリトライ。

ローカル開発

git clone https://github.com/twexapi-dev/paperclip-plugin-x-api-scraper.git
cd paperclip-plugin-x-api-scraper
pnpm install
pnpm check

pnpm check は型チェック、テスト、ビルドを実行します。