X Knowledge Agent

テーマ

日常ワークフロー ​

X Knowledge Agent の日常的な使い方を説明します。

自動実行フロー ​

毎朝8時に以下が自動実行されます:

mermaid
flowchart LR
    A[定時トリガー\n毎朝 8:00] --> B[Cookie 取得]
    B --> C[ブックマーク同期]
    C --> D[AI分類]
    D --> E[Obsidian エクスポート]
    E --> F[完了通知]

手動操作 ​

ブックマークの同期 ​

bash
# 手動で同期を実行
bash scripts/daily-sync.sh

Web UI での操作 ​

ブラウザで http://localhost:3001 にアクセスして以下の操作が可能です:

画面パス機能
ダッシュボード/統計概要、最新ブックマーク
ブックマーク一覧/bookmarksフィルタ、検索、カテゴリ表示
AI検索/ai-search自然言語でブックマークを検索
マインドマップ/mindmapカテゴリ関係のグラフ表示
分類パイプライン/categorizeAI分類の進捗モニタリング
インポート/import手動インポート（JSON）
設定/settingsAPI キー、モデル選択

CLI での操作 ​

サーバーを起動せずにデータベースに直接アクセスできます:

bash
# 統計情報
npx tsx cli/siftly.ts stats

# カテゴリ一覧（件数付き）
npx tsx cli/siftly.ts categories

# キーワード検索
npx tsx cli/siftly.ts search "AI agents"

# 最近のブックマーク
npx tsx cli/siftly.ts list --limit 10

# 特定のブックマークの詳細
npx tsx cli/siftly.ts show <id>

MCP Server 経由のアクセス ​

Claude Desktop などの MCP クライアントから直接ナレッジを活用できます:

mermaid
sequenceDiagram
    participant User as ユーザー
    participant Claude as Claude Desktop
    participant MCP as MCP Server
    participant DB as SQLite

    User->>Claude: 「最近のAI関連ブックマーク教えて」
    Claude->>MCP: search({ query: "AI", period: "1w" })
    MCP->>DB: FTS5 検索
    DB-->>MCP: 結果
    MCP-->>Claude: ナレッジ一覧
    Claude-->>User: 整理された回答

トラブルシューティング ​

Chrome が起動中の場合、Cookie DB がロックされることがあります。Chrome を閉じてからリトライしてください。

AI分類が動かない ​

bash
# Claude CLI の認証状態を確認
curl http://localhost:3001/api/settings/cli-status

# レスポンスの authenticated が true であることを確認

Obsidian に反映されない ​

エクスポート先のパスが正しいことを確認してください:

bash
# 設定画面で Vault パスを確認
open http://localhost:3001/settings