Sancho Fetch

Sancho Fetch

AI に公開データを頼みましょう。実際のファイルをコンピューターに取得できます。

まずは AI に伝えましょう

AI のコードモードを開きます。Claude デスクトップアプリの Code タブ、または ChatGPT デスクトップアプリの Codex を開き、任意のフォルダーを選んで、次の内容を貼り付けてください。

PyPI から Sancho Fetch をインストールして（uv tool install sancho-fetch）、このコンピューターで使えるように設定してください。uv がインストールされていない場合は、そのことを伝えてから、まずインストールしてください。完了したら、インストールに成功したかどうかを教えてください。次に、専門用語を使わず平易な英語で、.env ファイルとは何か、どのように使うのか、コンピューターのどこにあるのかを説明し、API キーを直接貼り付けられるように開いてください。無料の API キーが必要なデータソースの例をいくつかと、キーが不要なソースの例をいくつか教えてください。ダウンロードしたデータの保存先と、Sancho を後で更新する方法も教えてください。次に World Bank を使った短いデータ取得の例を実行して、データの保存先を確認できるようにしてください。最後に、データを取得するために伝えられる自然な言い回しの例をいくつか教えて、sancho-fetch の使い方をつかめるようにしてください。また、次の2点も忘れずに伝えてください。1）LLM デスクトップアプリの Code タブ（例：ChatGPT Desktop または Claude Desktop）を使っていれば、どこでも利用できます。2）sancho-fetch は簡単に拡張できるように作られているため、新しいデータソースの追加を AI に任せることもできます（さらに追加でき、AI が大部分を担って新しいデータソースに接続します）。

インストールはこれだけです。

このリポジトリをダウンロードしたり、クローンしたりする必要はありません。AI が実行するコマンドは次の2つです。

uv tool install sancho-fetch
sancho setup

一度インストールすれば、どこでも使えます。 Sancho はコンピューターに一度インストールするだけで、見つかった AI アプリ（Claude Desktop、ChatGPT/Codex、VS Code、Cursor）に接続します。セットアップの最後に、どのアプリがすぐ使える状態か、どのアプリは再起動またはクリックが必要かを、わかりやすく知らせます。

Sancho を使うには、データを頼むときに平易な英語で「sancho」と伝えるか、Claude Code で /sancho と入力すれば、使いこなしている気分になれます。

できること

• AI のコードモードで、「オハイオ州の郡別の喘息率を取得して」と頼みます。 作業するフォルダーはどこでもかまいません。Sancho は常にホームフォルダーの場所を把握しています。
• AI は Sancho を使って、120 以上の公開データソース（Census、World Bank、FDA、USGS、FEMA など）からデータを取得し、Excel で開けるファイルを渡します。
• すべてのデータはコンピューターに保存されます。

始める前に

通常、前提条件として uv が必要です。uv は Sancho を分離してインストールし、コンピューターのシステム Python を置き換えることなく、互換性のある Python を用意できます。初回のセットアップにはインターネット接続が必要です。インストールや World Bank の例に API キーは不要です。プロバイダー固有のキーは後から追加できます。

使い始める（約2分）

PyPI から直接インストールできます。

1. AI のコードモードを開きます。

• Claude： Claude デスクトップアプリ -> Code タブ -> 新しいセッション -> データを保存する任意のフォルダーを選択します。
• ChatGPT： ChatGPT デスクトップアプリ -> Codex -> そのフォルダーを開きます。

2. このページの上部にあるインストール依頼を貼り付けます。

AI がすべてをインストールし、最初のデータファイルを表示して、ファイルの保存場所を 案内します。

3. Sancho から再起動を求められたアプリを再起動します。 セットアップの最後に簡単な レポートが表示されます。アプリの再起動や追加のクリックが必要な場合は、分かりやすい 言葉で案内されます。

注意：使用する前に、利用したいデータソースの API キーを追加してください。

多くのデータソースではキーは不要です（World Bank、USGS、FEMA、openFDA など）。API キーが必要な場合は、AI が知らせます。 次のどちらかの方法で追加できます。

1. sancho-workspace フォルダーにある .env ファイルを開き、キーを貼り付けます。または
2. AI にキーのファイルを開くよう依頼します（sancho env open）。開いたファイルにキーを貼り付けてください。キーをチャットに貼り付けないでください。

通常、セットアップでは .env.example から .env が作成されます。.env がない場合は、 sancho env open を実行すると作成され、開きます。手動で行うには、同じフォルダーにある .env.example をコピーし、元のテンプレートを残したまま、コピーしたファイルの名前を .env にします。

両方のファイルは非表示になっている場合があります。

• macOS Finder： Cmd+Shift+.（Command + Shift + period）を押します。
• Windows File Explorer： 表示 -> 表示 -> 隠しファイル を選択します。

@開発者向け：Sancho はキー名だけを読み取り、値は読み取らないように設計されています。

GitHub リポジトリを使いたい場合、または AI アプリを使わずにインストールする場合

コントリビューション、カスタムモジュールの開発、オフラインインストールを行う場合は、 リポジトリのフォルダーから作業してください。 GitHub Desktop（無料）をインストールし、この リポジトリのページで Code -> GitHub Desktop で開く -> クローン をクリックします。

注意：Github フォルダーを iCloud／OneDrive 内のフォルダー（例：iCloud 内の Documents フォルダー）に置くことは避けてください。ファイルの同期や速度に問題が発生します。

次に、installers/Install Sancho.command（macOS）または installers/Install Sancho.bat（Windows）をダブルクリックします。Linux では bash installers/setup.sh を実行します。

• macOS では、初回起動がブロックされます（インストーラーは公証されていません）。システム 設定 -> プライバシーとセキュリティ を開き、ブロックされたファイルのメッセージまでスクロールして、 このまま開く を選択し、もう一度開きます。
• Windows：「Windows によって PC が保護されました」と表示されたら、詳細情報 -> 実行 をクリックします。

日常的な使い方

• Claude Code／Codex で、データを取得するよう依頼するだけです。Claude Code では /sancho と /sancho-update を直接入力することもできます。

インストール後は、Code セッションを使ってください。 Sancho は コンピューター全体にインストールされるため、今後のセッションで sancho-fetch フォルダーを追加する必要はありません。Claude Desktop では Code タブを選択します。 Codex では Code チャットを開始します。 通常のチャットからは、ローカルの Sancho インストールにアクセスできません。

• Sancho がデータ取得のたびに技術的でない詳細を返すよう、システム指示が設定されています。技術的な詳細も返してほしい場合は、AI に次のように伝えてください。

「Sancho の開発者モードをオンにして。」

• 何かおかしい場合は、AI に sancho ready を実行するよう依頼してください。セットアップを変更せずに状態を確認し、問題を報告します。問題を実際に修正するには、AI に sancho doctor --fix を実行するよう依頼してください。

ファイルの保存場所

your folder/
  sancho-downloads/    # <-- files you have downloaded via chatting with AI
  sancho-workspace/
    source/            # managed data modules
    custom/            # your own modules -- never overwritten when updating Sancho
    playbooks/         # your repeatable workflows
    fetched-data/      # faithful archive of every fetch (don't edit - this is a cache so we don't have to use API calls unnecessarily)
    analysis-data/     # your derived work
    outputs/           # reports, dashboards, exports
    logs/              # what Sancho did, when, and why
    update-backups/    # snapshots before every update
    .env               # your API keys (never logged, never printed)

データを取得するたびに、作業中のフォルダーにある sancho-downloads/ に開いて使う作業ファイルが保存され、sancho-workspace/fetched-data/ には元データに忠実なアーカイブ／キャッシュのコピーが保存されるため、同じデータを再度リクエストしたときにキャッシュが再利用されます。

テーブルは、01003 のようなコードをそのまま保持した Excel .xlsx ファイルとして保存されます。地図は GeoJSON／KML 形式のままです。情報が失われるような変換は行われません。ファイル名は日付から始まります。 2026-06-08_194211_alabama-population.xlsx。

独自のデータソースを追加する

AI に次のように伝えてください。

[その API／その機関のデータ／毎月受け取るこのファイル]用の Sancho モジュールを作成してください。

custom/ 内に作成され、組み込みのデータソースと同じように動作します。また、Sancho の更新によってこのフォルダーが上書きされることはありません。

良い例として、Sancho はワシントン D.C. とニューヨーク市のオープンデータポータルからデータを取得しています。これらのポータルは、共通の API／オープンデータポータル形式を使用しています。AI にほかの都市向けのモジュール作成を依頼すると、新しい都市が同じ形式を使っているかどうかを自分で判断し、同じ形式であれば同じモジュールコードの形式を再利用します（異なる場合は、新しいものを作成します）。Sancho の組み込みモジュールでまだ対応していない地域を対象に作業している場合、同じ形式を使う都市がどれほど多いか、きっと驚くはずです。ぜひ試してみてください。

更新

AI に次のように依頼してください。

Sancho を更新してください。

AI は PyPI から sancho コマンドをアップグレードし（uv tool upgrade sancho-fetch）、バックアップとロールバックコマンドを用意したうえで、安全にワークスペースを移行します。

代わりに GitHub リポジトリから作業していますか？GitHub Desktop で Fetch origin -> Pull origin を実行し、AI に 「Sancho を更新してください。」 と伝えてください。

更新時に、独自のファイル（custom/、playbooks/、fetched-data/、.env など）が変更されることはありません。

チャットで新しいバージョンについての通知（2 週間に 1 回表示されます）を停止するには、.env で SANCHO_UPDATE_NUDGE=false を設定してください。

アンインストール

インストール時と同じく、Code セッションで AI に依頼を 1 つ貼り付けてください。

このコンピューターから Sancho Fetch をアンインストールしてください。sancho uninstall を実行してから、 uv tool uninstall sancho-fetch を実行してください。sancho-workspace と sancho-downloads フォルダーは残してください。これらは私のデータと API キーです。完了したら、 何を削除したか教えてください。

（自分で実行する場合、アンインストールに必要なのはこの 2 つのコマンドだけです。）

Sancho が削除するのは、自身がインストールしたものだけです。スキルと AI アプリ内の登録項目は削除します。自分で編集または作成したものには手を加えず、その旨を報告します。

sancho-workspace/ フォルダー（取得したデータ、カスタムモジュール、.env のキー）と sancho-downloads/ 内のファイルは、常に保持されます。データの削除は別途、確認を求めたうえで意図的に行う必要があります。AI に依頼するか、 sancho uninstall --help を実行して方法を確認してください。

プライバシーポリシー

Sancho はお使いのコンピューター上で動作し、データもそこに保存します。データの取得は、お使いのコンピューターから選択した公開データプロバイダーへ直接行われます。API キーはローカルの .env から読み込まれ、そのプロバイダーにのみ送信されます。Sancho はテレメトリーを収集しません。詳細は docs/PRIVACY.md をご覧ください。

そのほかのドキュメント

• CHANGELOG.md -- 各リリースでの変更内容。
• README_ALL_INSTRUCTIONS.md -- オペレーター／AI 向けの完全なリファレンス。
• project-docs/MCP_SERVER_SETUP_CLAUDE_CHATGPT_WEB.md -- デスクトップクライアントとウェブクライアント向けの MCP セットアップの詳細。
• project-docs/MODULE_CREATION_GUIDE.md -- AI が新しいデータモジュールを作成する方法。

Sancho の独自バージョンをホストする

Sancho は自分のコンピューター上で動作するよう設計されていますが、サーバーにホストすれば、ユーザーは Claude／Codex のデスクトップアプリを必要とせず、ウェブ経由でアクセスできます。

ホスト機能は主に、Sancho を自分のコンピューターにインストールする技術的なスキルを持たないユーザー向けに、実地ワークショップを開催する組織を支援する目的で用意されました。

• hosting/README.md -- イベント向けのホスト型デモエンドポイント。

AI アシスタント向け

AI アシスタントの場合、このクイックスタートを使って操作しないでください。 README_ALL_INSTRUCTIONS.md を読み、 CLAUDE.md または AGENTS.md に従ってください。

ライセンス

コードは MPL 2.0、ドキュメントは特に記載がない限り CC BY 4.0 のライセンスに基づいています。Sancho の名称、ロゴ、ブランドアセットは別途保護されています。詳しくは LICENSE、NOTICE、LICENSE-DOCS.md、INTENDED_USE.md をご覧ください。