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がすべて処理します。

中身の紹介

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 によって構築されました。