sync: update from private repo (ddadfd71)

docs/tools/xsearch.md

@@ -87,13 +87,39 @@ XTimeline({
 
 ```js
 XPostDetail({
-  url: "https://twitter.com/.../status/1234567890",
-  // または status_id: "1234567890"
+  tweet: "https://x.com/.../status/1234567890",
+  // tweet ID だけでも、長文記事 URL (https://x.com/.../article/1234567890) でも可
 })
 ```
 
 返り値にはリプライツリーが含まれる。議論の流れを追いたいときに使う。
 
+### X 長文記事（X Articles）
+
+対象が長文記事ポストの場合、`text` は記事への t.co リンク 1 本だけになる。
+記事の中身は `article` キーに入る:
+
+```yaml
+data:
+  - id: '1234567890'
+    text: https://t.co/xxxx        # 記事ポストの本文はリンクのみ
+    article:
+      title: 記事タイトル
+      previewText: 冒頭のプレビュー文
+      plainText: 記事本文の全文（プレーンテキスト）
+      publishedAtISO: '2026-07-02T00:04:51+00:00'
+      coverImageUrl: https://pbs.twimg.com/media/XXXX.jpg
+```
+
+- `plainText` はデフォルトで 12,000 文字で切り詰め、`plainTextTruncated: true` が付く。
+  全文が必要なら `full_text: true` を渡す
+- **記事内の埋め込み画像・動画は `media[]` に合流する**（先頭 20 件まで）。通常の
+  投稿メディアと同じく自動ダウンロードされ `localPath` が付くので、そのまま
+  ReadImage / AnnotateImage に渡せる。動画の扱いは `tools.x_download_video` に従う
+- カバー画像（`coverImageUrl`）は自動ダウンロード対象外。必要なら DownloadFile に渡す
+- 記事ページ（`x.com/{user}/article/{id}`）を WebFetch で読むことはできない
+  （ログイン壁で失敗する）。記事は必ずこのツールで取得する
+
 ## 出力フォーマット
 
 - デフォルト: 構造化テキスト（投稿者・本文・いいね数等）