Twitterの検索キーワードを1つと期待件数を指定すると、一致する公開投稿の識別子、公開日時、収集メタデータを取得します。
概要
Twitter のプロフィールを手でスクロールせずに、そのアカウントが何を投稿しているかを一覧にしたいですか?この App に公開 Twitter アカウント ID と最大投稿数を渡すと、そのアカウントの公開投稿を 1 件ずつ返します。各レコードにはコンテンツ ID、公開日時、収集日時、投稿に付いているアカウント識別子が含まれるので、調査やモニタリングのチームはタイムラインをウェブページではなくデータセットとして扱えます。
プロフィールページは投稿を 1 件ずつ読むためのものです。このリストは比較のためのものです。公開日時を並べ、コンテンツ ID を投稿元アカウントの横に置き、各行がいつ収集されたかを確認できます。値はスクリーンショットから復元したものではなく、各投稿とともに取得された公開識別子とタイムスタンプです。
データ説明
レコードは Twitter アカウントの公開投稿一覧から取得され、公開日時の新しい順です。各行は公開投稿 1 件で、同じコンテンツ ID は 1 回だけ現れます。キーワードとビジネス ID は投稿に保存されたアカウント識別子を繰り返します。公開日時、収集日時、クレンジング更新日時はタイムゾーンが明示されていないタイムスタンプです。非公開、保護、削除済み、ログイン限定の投稿は含まれません。
結果の形
各レコードは、指定したアカウントの公開投稿 1 件です。
| コンテンツ ID | 公開日時 | キーワード | ビジネス ID | 収集日時 | レコード ID |
|---|---|---|---|---|---|
| 2092517966604870070 | 2023-01-07T16:15:39 | 1611637588921815040 | 1611637588921815040 | 2026-08-26T17:24:16 | 6a8eb0c1a247355e51208cb2 |
| 2092518471989182858 | 2023-01-07T16:15:39 | 1611637588921815040 | 1611637588921815040 | 2026-08-26T17:24:16 | 6a8eb0c1a247355e51208cb0 |
キーワード種別、ソース識別子、クレンジング更新日時、データなしフラグも、存在する場合は返されます。
利用シーン
- 収集した公開投稿について、コンテンツ ID、公開日時、キーワードを並べてアカウントのインベントリを作る。
- レポートでコンテンツ ID を使う前に、ビジネス ID で意図したアカウントかを確認する。
- 収集日時と公開日時を並べ、各投稿がいつ取得されたかを追う。
適用範囲と境界
1 回の実行で処理する Twitter アカウント ID は 1 件です。指定した投稿数は厳格な上限であり、実際の返却件数はこの値を超えません。取得保護は結果 1,000 ページです。公開されている投稿のみが対象です。
- 適している用途
- 特定の Twitter アカウントの公開投稿一覧が必要なとき
- それらの投稿のコンテンツ ID、公開日時、収集タイムスタンプが必要なとき
- 適さない用途
- 非公開、保護、削除済み、またはログイン限定の投稿が必要なとき
- 投稿の識別子とタイムスタンプではなく、本文、メディア、エンゲージメント数、プロフィール詳細が必要なとき
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1データが返らない場合は、Twitter アカウント ID を確認し、公開投稿があることを確かめてください
- 2レート制限、一時的な利用不可、タイムアウトの後は後で再試行してください
- 3投入結果が不明なときは、重複タスクを作らないようすぐには再投入しないでください
- 4認証に失敗した場合は、実行環境に設定した API Key を確認してください
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- Twitter アカウント ID
account_id必須string収集する Twitter アカウント ID。例: 1611637588921815040。1 回の実行で処理する ID は 1 件です。1〜512 文字で指定します。例1611637588921815040 - 最大投稿数
crawl_num必須integerこのアカウントから収集する公開投稿の最大件数です。実際の返却件数はこの値を超えません。値を大きくすると時間がかかります。範囲1–2000例1
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- ビジネス ID
biz_idstring投稿レコードに保存されたビジネス識別子。空の場合があります。例1611637588921815040 - クレンジング更新日時
clean_update_timestringこのレコードが最後にクレンジングされたタイムスタンプ。空の場合があり、タイムゾーンは明示されません。例2026-08-26T17:24:17 - コンテンツ ID
content_idstringTwitter 投稿の公開識別子。空の場合があります。例2092517966604870070 - 収集日時
crawl_timestringこの投稿が収集されたタイムスタンプ。空の場合があり、タイムゾーンは明示されません。例2026-08-26T17:24:16
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"biz_id": "1611637588921815040",
"clean_update_time": "2026-08-26T17:24:17",
"content_id": "2092517966604870070",
"crawl_time": "2026-08-26T17:24:16",
"cur_id": "6a8eb0c1a247355e51208cb2",
"keyword": "1611637588921815040",
"keyword_type": "account",
"no_data": false,
"publish_time": "2023-01-07T16:15:39",
"source_item": "1611637588921815040"
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/twitter-account-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。