twitter-scraping

Twitter スクレイピング

認証の設定

すべてのスクレイパーには、x.com の auth_token Cookie が必要です（DevTools → Application → Cookies から auth_token の値をコピーしてください）。

Node.js スクレイパー API

npm install xactions -- src/scrapers/index.js のすべての関数を利用できます。

import { createBrowser, createPage, loginWithCookie, scrapeProfile } from 'xactions';

const browser = await createBrowser();
const page = await createPage(browser);
await loginWithCookie(page, AUTH_TOKEN);

const profile = await scrapeProfile(page, 'nichxbt');
await browser.close();

関数	用途
scrapeProfile(page, username)	プロフィールデータ（自己紹介、フォロワー数、フォロー数）
scrapeFollowers(page, username, {limit})	フォロワーの一覧
scrapeFollowing(page, username, {limit})	フォロー中のユーザーの一覧
scrapeTweets(page, username, {limit})	ユーザーのツイート
searchTweets(page, query, {limit})	検索結果
scrapeHashtag(page, tag, {limit})	ハッシュタグのツイート
scrapeThread(page, tweetUrl)	スレッドのツイート
scrapeMedia(page, username, {limit})	メディアの URL
exportToJSON(data, path) / exportToCSV(data, path)	ファイルへのエクスポート

ブラウザーコンソールスクリプト

単体で動作する IIFE です。x.com の DevTools コンソールに貼り付けてください。依存関係はありません。

スクリプト	ファイル	移動先
動画をダウンロード	src/scrapers/videoDownloader.js	動画付きのツイート
ブックマークをエクスポート	src/scrapers/bookmarkExporter.js	x.com/i/bookmarks
スレッドを展開	src/scrapers/threadUnroller.js	任意のスレッド
バズったツイートを検索	src/scrapers/viralTweets.js	ユーザープロフィール
フォロワーをスクレイピング	scripts/scrapeFollowers.js	x.com/USER/followers
フォロー中のユーザーをスクレイピング	scripts/scrapeFollowing.js	x.com/USER/following
プロフィールをスクレイピング	scripts/scrapeProfile.js	ユーザープロフィール
検索結果をスクレイピング	scripts/scrapeSearch.js	検索結果
ハッシュタグをスクレイピング	scripts/scrapeHashtag.js	x.com/hashtag/TAG
いいねをスクレイピング	scripts/scrapeLikes.js	x.com/USER/likes
いいねしたユーザーをスクレイピング	scripts/scrapeLikers.js	任意のツイート
返信をスクレイピング	scripts/scrapeReplies.js	任意のツイート
メディアをスクレイピング	scripts/scrapeMedia.js	ユーザーのメディアタブ
DM をスクレイピング	scripts/scrapeDMs.js	x.com/messages
通知をスクレイピング	scripts/scrapeNotifications.js	x.com/notifications
リストをスクレイピング	scripts/scrapeList.js	任意の X リスト
ブックマークをスクレイピング	scripts/scrapeBookmarks.js	x.com/i/bookmarks
CSV にエクスポート	scripts/exportToCSV.js	任意のスクレイピングの後
リンクをスクレイピング	scripts/linkScraper.js	任意のタイムライン
引用リツイート	scripts/scrapeQuoteRetweets.js	任意のツイート

インタラクティブなブラウザーツールボックス（コンソールでのスクレイピングにおすすめ）

コンソールに貼り付けてスクレイピングする場合は、scripts/twitter/scraper-toolbox.js をおすすめします。ページ上にコントロールパネルが表示され（開始／一時停止／停止、リアルタイムフィルター、ユーザーの除外、キーワードルール）、X 独自の GraphQL レスポンスを取得するため、件数は正確な整数になり、長い投稿も途中で切り捨てられません。JSON／CSV／Markdown／TXT／HTML 形式でエクスポートし、クリップボードにコピーできます。プロフィール、検索、リスト、いいね、ブックマーク、ホームなど、あらゆるタイムラインで動作します。ドキュメント： scripts/twitter/README-scraper-toolbox.md。

MCP スクレイピングツール

すべてのスクレイパーは、AI エージェント向けに MCP サーバーから利用できます。

ツール	説明
x_get_profile	ユーザープロフィールをスクレイピング
x_get_followers	フォロワーの一覧を取得
x_get_following	フォロー中のユーザーの一覧を取得
x_get_tweets	ユーザーのツイートを取得
x_search_tweets	ツイートを検索
x_get_thread	スレッドを展開
x_download_video	動画 URL を抽出

注意事項

• Node.js スクレイパーの使用後は、必ず browser.close() を呼び出してください
• ブラウザースクリプトはページ遷移時に停止します。実行中はページを移動しないでください
• すべてのスクリプトは JSON および CSV 形式でのエクスポートに対応しています
• より多くのデータをスクレイピングするには、limit パラメーターを大きくしてください（デフォルト値は関数によって異なります）
• レート制限が組み込まれています。待ち時間をデフォルト値より短くしないでください