PIL

あなたのInstagram保存投稿 — AIが深く読み取り、永遠に検索可能、あなたのマシン上で。

はじめる · 仕組み · 他のAIツール · 中身

mcp-name: io.github.pjpoulose/pil

PILを3ステップで入手

1. これをMuseにコピー＆ペースト:

    https://github.com/pjpoulose/PIL をワークスペースにクローンし、その
    SKILL.md に従って Personal Instagram Library をセットアップしてください。ステップバイ
    ステップで進めてください — インストール、保存投稿からライブラリを構築し、
    インストール可能なアプリを渡してください。

2. 求められたら、Instagramをリンク（ブラウザでワンタップ）。

3. 送られてきたアプリファイルをダウンロード → 解凍 → Start PIL をダブルクリック → Install をクリック。

これだけです。Museがセットアップ、読み取り、構築をすべて行います。 スマホでも使いたい？ そのままMuseに頼んでください — それも処理してくれます。

自分でやりたい？ 1つのコマンドですべてをセットアップします。

• Mac / Linux: curl -fsSL https://raw.githubusercontent.com/pjpoulose/PIL/master/bootstrap.sh | bash
• Windows (PowerShell): irm https://raw.githubusercontent.com/pjpoulose/PIL/master/bootstrap.ps1 | iex

その後、手動セットアップ のコマンドでライブラリを構築します。

毎日、二度と見つけられない投稿を保存しています。PIL (Personal Instagram Library) は、あなたのInstagram保存コレクションを、自分のマシン上のプライベートな知識ベースに変えます：すべての投稿をビジョンAIが深く読み取り — ナラティブ要約、要点、ハウツーステップ、言及されたリンク、自動タグ — 数秒で検索可能になり、AIコーディングツールからライブで照会できます。

コードは共有、データは自宅に。 このリポジトリにはコード、データベーススキーマ、設定例、ドキュメントのみが含まれます。あなたの保存投稿、キャプション、アカウント詳細は決してコンピュータから離れません — 取り込み、抽出、検索、MCPサーバーはすべてローカルで実行されます。.gitignore がデータベース、設定、エクスポートがコミットされるのを防ぎます。

サンプルデータを使ったコンセプトモックアップ — あなたのライブラリはこのようになります。

Claude、Codex、Cursorからアクセスしたい？

読み取り専用のMCPサーバーを接続すると、他のAIツールがライブラリをライブで照会できます — 常に最新、再アップロード不要。Museが配線してくれます。 接続方法 →

仕組み

flowchart LR
    A["Instagram saved posts"] -->|"ingest"| B["Local SQLite on your machine"]
    B -->|"vision AI<br/>deep read"| C["Summaries, key points, how-tos, links, tags"]
    C --> D["Query two ways"]
    D --> E["MCP server — Cursor, Claude Code, Desktop"]
    D --> F["Static JSON export — any AI tool"]

手動セットアップ（自分でやる場合）

# 1a. Install from PyPI (recommended — no clone needed)
pip install personal-instagram-library
# gives you: pil-mcp pil-ingest pil-extract pil-tag
#            pil-export-web pil-export-html pil-export-pwa pil-publish-pwa

# 1b. Or get the code
git clone https://github.com/pjpoulose/PIL.git pil && cd pil

# 2. Configure (your data lives in data_dir, default ~/.local/share/pil)
cp pil.config.example.json ~/.config/pil/pil.config.json
# edit it: set account_id to your user_fbid from `instagram-cli accounts`

# 3. MCP server dependency
pip install "mcp<2"

cd bin
python3 ingest_saved.py      # collections + saved posts
python3 extract_content.py   # vision-AI deep read (batches of 25)
python3 tag_all.py           # programmatic tags for untagged posts
python3 export_web.py        # static JSON export -> <data_dir>/web_data.json
python3 export_html.py       # searchable HTML dashboard -> <data_dir>/pil_library.html
python3 export_pwa.py        # installable PWA bundle -> <data_dir>/pwa/

python3 bin/mcp_server.py    # read-only, stdio — Ctrl-C to stop

保存タブをスクロールするだけではダメな理由

他のAIツールからライブラリに質問

ライブ（推奨）: MCP。 MCP互換のアシスタントを読み取り専用サーバーに 向けると、すべての質問が現在のデータベースを読み取ります — 常に 最新、エクスポート不要、再アップロード不要:

python3 /path/to/pil/bin/mcp_server.py    # stdio; Ctrl-C to stop

Claude Code、Claude Desktop、Cursor用の配線: references/mcp_clients.md。MCP互換の クライアントならどれでも動作します — 設定を触りたくない場合はMuseが接続してくれます。 利用可能なツール:

サーバーはSQLite mode=ro でデータベースを開き、SELECT専用の ツールを公開します — ライブラリを変更することはできません。（攻撃テスト済み: SQLインジェクション、書き込み 試行、制限の悪用はすべてブロックされることを確認済み。）

スナップショット: ファイルアップロード。 Museに web_data.json ファイルを 送ってもらいます（export_web.py で構築）: すべての投稿とその深読み知識が1つの ファイルに。任意のAIチャット（Claude、ChatGPTなど）に添付して、ドキュメントのように 質問できます。エクスポート時点で固定されています — スナップショットであり、ライブ接続では ないため、新しい投稿を保存した後はMuseに新しいコピーを依頼してください。

直接（上級者向け）。 データベースは <data_dir>/pil.sqlite にあるプレーンなSQLiteです （スキーマは schema.sql）。任意のSQLiteツールで読み取り専用で開けます。

これらのファイルにはあなたの個人Instagramデータが含まれています — 自分のマシンに 保管し、信頼できるツールとのみ共有してください。

ライブラリをアプリとして

Museがアプリを構築して送ってくれます — コンピュータ用と スマホ用。ただ依頼するだけ:

• "PILアプリを送って" — 送られてきたファイルをダウンロード、解凍、Start PIL を ダブルクリック、Install をクリック。他のアプリと同じようにコンピュータに インストールされ、完全にオフラインで動作します。
• "PILをスマホに入れて" — 公開処理を行い、スキャン用のQRコードを 渡します。Install（Android）または Share → Add to Home Screen （iPhone）をタップ。

コマンド不要、ホスティング設定不要、ターミナル不要 — Museがすべて処理します。

Signal Deck — ビジュアルダッシュボード (v1.2.0)

クエリより探索が好き？ Signal Deck (dashboard/) は、 ローカルのPILデータベースから自己完結型のHTMLダッシュボードを構築します: 保存したすべてを テーマリングのヒーロー、検索 → 統合（The Brief）、ソースレール、 スティッキーインデックス、完全なアーカイブグリッド。1つのファイル、オフラインで動作、 データがマシンから離れることはありません。

cd dashboard
PIL_DB=~/.local/share/pil/pil.sqlite python3 build-signal.py
# open pil-signal-deck.html in Chrome/Safari

詳細、PWAノート、QAスイートについては dashboard/README.md を参照。

中身

pil/
├── assets/logo.svg          # the seal above
├── SKILL.md                 # skill definition (for Muse)
├── README.md                # this file
├── LICENSE                  # MIT
├── schema.sql               # the five tables: folders, posts, post_folders, knowledge, tags
├── pil.config.example.json  # copy to pil.config.json and set your account_id
├── bootstrap.sh             # one-line installer for Mac/Linux
├── bootstrap.ps1            # one-line installer for Windows
├── bin/
│   ├── pil_common.py        # config resolution + DB helpers
│   ├── ingest_saved.py      # step 1: ingest (resume-safe)
│   ├── extract_content.py   # step 2: vision-AI extraction (resume-safe)
│   ├── tag_all.py           # step 3: tagging
│   ├── export_web.py        # step 4: static export
│   ├── export_html.py       # step 5: self-contained HTML dashboard
│   ├── export_pwa.py        # step 6: installable PWA bundle (manifest + SW + icons)
│   ├── publish_pwa.py       # step 7: publish PWA to your own host for phone install
│   └── mcp_server.py        # read-only MCP server (stdio)
└── references/
    └── mcp_clients.md       # Cursor / Claude Code / Claude Desktop wiring

FAQ

コーディングの知識は必要ですか？ いいえ。このページ上部のプロンプトをMuseにコピー＆ペーストするだけ — すべてを 一緒にやってくれます。自分で行うのは、Instagramのリンク（ブラウザでワンタップ）と 送られてきたアプリファイルのダウンロードだけです。

Instagramデータはどこに行きますか？ どこにも行きません。コードは共有、データは自宅に: あなたの保存投稿、キャプション、 アカウント詳細は決してコンピュータから離れません。私たちにアップロードされるものは ありません — 「私たち」は存在しません; サーバーも、アカウントも、クラウドもありません。

費用はかかりますか？ PILは無料でオープンソース（MIT）です。サブスクリプションもアカウント作成も ありません。AI深読みステップは、あなた自身のInstagram/AIセットアップを通じて実行されます。

アプリはオフラインで動作しますか？ はい。インストール後、デスクトップアプリとスマホアプリは完全にオフラインで動作します — 検索、 ルーム、タグ、回答はすべてインターネットなしで機能します。

対応するスマホとコンピュータは？ デスクトップアプリはWindows、Mac、Linux; スマホアプリはiPhoneとAndroid。 AndroidではChromeで Install app をタップ; iPhoneではSafariの Share → Add to Home Screen を使用。

新しい投稿を保存しました — どう追加しますか？ Museに「新しい投稿を保存した」と伝えるだけ。新しい投稿のみを取得して深く読み取り、 その後アプリとファイルを更新します。

ライブラリを誰かと共有できますか？ ライブラリはマシン上のファイルです — 他の人のコンピュータにコピーすることは できますが、あなたの個人Instagramデータが含まれています。プライベートなものとして 扱ってください: 公開場所に公開したりアップロードしたりしないでください。

何かが失敗しました — どうすれば？ 見た内容をMuseに伝えてください — 直接診断して修正できます。（手動 セットアップを実行中？ インストーラーを再実行 — 何回でも安全に実行できます — そして python3 --version が3.11+であることを確認してください。）

トラブルシューティング

何か問題が？ 何が起こったかMuseに伝えてください — ほとんどの問題を 自分で診断して修正できます。

手動セットアップを自分で実行中？

• PIL account_id is not configured → サンプル設定をコピーし、 account_id を instagram-cli accounts の user_fbid に設定。
• 巨大なライブラリでは抽出が遅い — 再開可能なので、再実行するだけ。
• 429 のレート制限はスクリプト内でバックオフで処理されます。
• MCPサーバーは、実行するPythonに mcp<2 が必要です（2.xでAPIがリネームされました）。

コントリビューション

PRとイシュー歓迎 — より良い抽出プロンプト、新しいクエリクライアント、新しい エクスポート形式。フォークして、出荷して、自分仕様に。延々と続くスクロールから 救われたなら、スターが他の人が見つける助けになります。

ライセンス

MIT。Paul Poulose によって構築されました。