browse-x について
browse-x は、ブラウザーや X へのログインを使わずに公開コンテンツを取得するスキルです。コマンドラインから Markdown または構造化データを返し、投稿などの書き込みには対応せず、結果の制約も示します。
主な機能
- 01公開投稿や記事の取得
- 02プロフィールとオリジナル投稿の確認
- 03フォロワーとフォロー先の確認
- 04公開 X コンテンツの検索
- 05Markdown または JSON で出力
活用シーン
- 01文書内の X リンクを読む
- 02公開アカウントの紹介文と最近の投稿を確認
- 03投稿内容をノートに保存
- 04X の検索結果をデータとして取得
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ pc-style/ x-md --skill browse-xインストール後、Claude Code で/browse-xを入力して読み込まれたか確認します。
同梱ファイルscripts/browse-x.tstests/browse-x.test.ts
詳細
browse x
mdfromx.com を通じて公開コンテンツを取得します。X へのログインは不要です。このスキルのディレクトリからヘルパーを実行してください。
使用する場面
公開されている X のコンテンツを今すぐ 1 件読み取る必要がある場合に使用します。
- 公開されている X の投稿、スレッド、または X Article の本文が必要で、ブラウザーを実行したり X にログインしたりできない場合。
- ドキュメント、issue、変更履歴、チャットログ内にある
x.com、twitter.com、またはt.coのリンク先のコンテンツを、その場で確認する必要がある場合。 - 公開プロフィールの自己紹介と最新のオリジナル投稿(返信とリポストを除外)を確認したい場合。
- 公開アカウントが誰をフォローしているか、または誰にフォローされているかを確認したい場合。
- X の検索結果を、レンダリングされたタイムラインではなくデータとして取得したい場合。
- 投稿をノートやボルトに保存したい場合 —
--format obsidianを指定すると YAML フロントマターが出力されます。
使用しない場面
- 書き込みを伴う操作。投稿、返信、フォロー、いいね、ブックマーク、DM の送信は一切行わず、X の認証情報も使用しません。
- 非公開、保護、凍結、削除されたアカウントや投稿。これらは取得できず、ロックを解除するフラグもありません。
- X Lists、DM、通知、パーソナライズされたホームタイムライン、アカウント分析。これらはサポートされていません。
- 大量収集、過去データの一括取得、データセットの構築。レート制限があり、一度に 1 件の質問を処理するようキャッシュされています。
- 完全性や SLA の保証が必要なもの。結果は公開されている上流プロバイダーから取得されるため、遅延したり切り詰められたりすることがあります。決めつけずに
warningsを確認してください。
bun scripts/browse-x.ts "https://x.com/handle/status/123"
bun scripts/browse-x.ts profile handle
bun scripts/browse-x.ts search "from:handle release"
bun scripts/browse-x.ts followers handle
bun scripts/browse-x.ts following handle
オプション
デフォルトでは Markdown 形式です。構造化出力には --json、メタデータを含めるには --full、出力を短くするには --compact を指定します。続きを取得するには、返されたカーソルを --cursor とともに使用してください。スレッド、フィード、その他のオプションについては、bun scripts/browse-x.ts --help を実行してください。
任意:X_MD_API_KEY を指定するとベアラキーを送信します。X_API_BASE を指定するとホストを変更できます。キーを出力しないでください。無効または無効化されたキーは 401 を返します。
制限事項
公開リクエストとキー付きリクエストでは、クォータが異なります。429(終了コード 3)の場合は、表示された Retry-After の時間だけ待ってください。再試行を繰り返さないでください。終了コード 2 は引数の誤り、終了コード 1 はその他のエラーを示します。非公開または削除されたコンテンツは取得できない場合があります。warnings を確認し、欠落している返信、メディア、固定投稿を捏造しないでください。