はじめに

X Knowledge Agent のセットアップ手順を説明します。

前提条件

要件	詳細
Node.js	18 以上
ブラウザ	Chrome / Chromium / Brave（Cookie 抽出に必要）
Claude Code CLI	ログイン済み（AI分類に使用）
OS	macOS / Windows / Linux

オプション

• cloudflared — リモートアクセス用（Cloudflare Tunnel）
• Rust toolchain — Tauri デスクトップアプリのビルド用
• Docker — OSS検証サンドボックス用

インストール

# 1. リポジトリをクローン
git clone https://github.com/aieo-product/xbookmark-skill.git
cd xbookmark-skill

# 2. セットアップスクリプトを実行
bash scripts/setup.sh

セットアップスクリプトは以下を自動実行します:

1. npm install — 依存パッケージのインストール
2. npx prisma generate && npx prisma db push — データベースの初期化
3. launchd / systemd ジョブの登録（毎朝8時の自動同期）

初回同期

Chrome で X（twitter.com）にログインした状態で以下を実行します:

bash scripts/daily-sync.sh

このスクリプトが行うこと:

sequenceDiagram
    participant Chrome as Chrome Browser
    participant Script as daily-sync.sh
    participant Keychain as OS Keychain
    participant X as X GraphQL API
    participant DB as SQLite
    participant Claude as Claude CLI
    participant Obsidian as Obsidian Vault

    Script->>Chrome: Cookie DB 読み取り
    Chrome-->>Script: auth_token + ct0
    Script->>Keychain: 認証情報を保存
    Script->>X: ブックマーク取得（ページネーション）
    X-->>DB: 新規ブックマークを保存
    Script->>Claude: AI分類パイプライン実行
    Claude-->>DB: 分類結果を保存
    Script->>Obsidian: Markdown エクスポート

ブラウザで確認

# 開発サーバーを起動
npm run dev

# ブラウザで開く
open http://localhost:3001

次のステップ

• 設定 — API キー、カテゴリ、エクスポート先の設定
• 日常ワークフロー — 毎日の運用フロー
• アーキテクチャ概要 — システム全体の設計