Bookipi

Bookipi CLI

請求書、支払い、顧客、経費、提案書、契約書、レポートなどのバックオフィス業務を、平易な英語で Claude に依頼するか、--json コマンドを使って自分のコードから実行できます。

メールの送信、支払いの記録、公開を伴う操作は、すべて事前に確認を求めます。また、Bookipi が資金を動かすことはありません。概要：bookipi.com/cli。

目次

1. 使い方
2. スキルをインストールする — Claude Desktop と Cowork · Claude Code · Codex · Gemini CLI · その他のエージェント
3. ネットワークアクセスを許可する（Cowork）
4. サインインとワークスペース
5. 依頼できること
6. CLI を使って開発する — コマンド
7. ヘルプとバグ報告
8. プライバシー
9. ライセンス

使い方

やりたいこと	使うもの
Claude（Cowork、Claude Desktop、Claude Code、Codex、Gemini CLI）に依頼する	スキル — CLI が含まれています
claude.ai または任意の MCP クライアントで Bookipi を使う（インストール不要）	Bookipi コネクター — MCP Registry にも io.github.Bookipi-Group/bookipi として登録されています
スクリプトを作成する、または独自のエージェントや製品に組み込む	CLI

どの方法でも、内部では同じツールが使われます。

スキルをインストールする

スキルには Bookipi CLI が含まれているため、ほかにインストールするものはありません。自分のコンピューター上で実行する場合（Claude Code、Codex、Gemini CLI）は Node 22.12+ が必要です。初回使用時に ~/.local/bin に bookipi コマンドが追加されるため、CLI を自分で実行することもできます。

Claude Desktop と Cowork

1. 最新リリースから bookipi-cli.skill をダウンロードします。
2. ダブルクリックして確認します。スキル一覧に bookipi-cli として表示されます。

何も起きませんか？ファイルを Cowork ウィンドウにドラッグしてください。ブラウザーによって .skill 拡張子が削除された場合は、先に元に戻してください。

Claude Code

/plugin marketplace add Bookipi-Group/bookipi-cli
/plugin install bookipi@bookipi-cli

アップグレードするには、まずマーケットプレイスを更新してからアップデートします（@bookipi-cli の部分はそのままにしてください。変更すると「Plugin not found」と表示されます）：

/plugin marketplace update bookipi-cli
/plugin update bookipi@bookipi-cli

Claude Desktop にインストールしたスキルは、デスクトップアプリから開始した Claude Code のセッションでも使えます。手動でインストールするには、.skill ファイルを ~/.claude/skills/ に解凍します。

Codex

/plugin marketplace add Bookipi-Group/bookipi-cli
/plugin install bookipi

Gemini CLI

gemini extensions install https://github.com/Bookipi-Group/bookipi-cli

アップグレードするには gemini extensions update bookipi を実行します。この拡張機能にはBookipi コネクターも含まれています。/mcp auth bookipi を一度実行してサインインすると、スキルは CLI の代わりにコネクターを使います。

その他のエージェント

Cursor、GitHub Copilot、Antigravity、Windsurf など、スキルを読み込むほかのエージェントには、skills CLIを使ってインストールします：

npx skills add Bookipi-Group/bookipi-cli --skill bookipi-cli

アップグレードするには npx skills update bookipi-cli を実行します。または、このリポジトリの .agents/skills/bookipi-cli/ を、プロジェクトまたはエージェントのスキルフォルダーに手動でコピーしてください。

ネットワークアクセスを許可する（Cowork）

Claude Code を使う場合、またはワークスペースの管理者がすでに以下のドメインを追加している場合は、この手順をスキップしてください。

Cowork は不明なウェブサイトをブロックするサンドボックス内で動作するため、Bookipi を組織の許可リストに追加しないとサインインできません。管理者は、Organization Settings → Capabilities → Code execution → Additional allowed domains で以下を追加します。

*.bkpi.co
*.bookipi.com
*.bookipay.com
*.s3.amazonaws.com
*.amplitude.com

最初の3つは Bookipi のサーバーです。S3 は領収書のアップロードと、請求書プレビューの画像に使用します。いずれかが不足していると、最初のリクエスト時に Claude がその旨を伝えて、これらのドメインを一覧表示します。その内容を管理者に転送してください。

サインインとワークスペース

Bookipi の各ワークスペースは、コンピューター上のフォルダーです。サインイン情報はそのフォルダーの .bookipi/（git の追跡対象外）に保存されるため、そのフォルダーでのセッションは毎回サインイン済みの状態になります。

1. Cowork： New Project → Use a folder → フォルダーを選択します。 Claude Code： 任意のフォルダーで claude を起動します。
2. 「このフォルダーで Bookipi をセットアップして」 と尋ねます。Claude がサインインリンクを表示します。
3. 「誰としてログインしていますか？」 と尋ねて確認します。

別の Bookipi アカウントを使う場合は、別のフォルダーを使用してください。

フォルダーを指定していない Cowork プロジェクトはクラウド専用で、チャットのたびに消去されるため、毎回サインインが必要です。フォルダーを追加するか、サインイン情報を Claude アカウントに保持する Bookipi connector を使用してください。

Claude Code ではフォルダーの指定は任意です。「Bookipi にログインして」 と伝えるだけで、コンピューター上のすべてのフォルダーで使えるように、サインイン情報が ~/.bookipi/ に保存されます。

質問例

	お試しください
未払い金	「誰が私にお金を支払っていませんか？」 · 「期限超過の請求書を表示して」 · 「期限超過の請求書すべてにリマインダーを送って」
請求書	「Acme にコンサルティング料5,000ドルの請求書を作成して」 · 「INV-650 の見た目を確認させて」 · 「INV-650 を [email protected] に送って」 · 「INV-650 を支払済みにして」
顧客	「Wayne Construction の情報を開いて」 · 「新しい顧客を追加して：Acme Corp、[email protected]」 · 「Maria に、通話に遅れるとメールして」
取引と提案書	「取引を追加して：Stark のキッチン改装、40,000ドル」 · 「Stark の取引の提案書を作成して」 · 「Stark の取引を成約済みにして」
契約	「承諾された提案書を契約書にして」 · 「Bruce に MSA を送って」 · 「Bruce はもう署名しましたか？」
経費	領収書を追加して、「これを経費として記録して」 · 「今月の経費を表示して」
レポート	「朝の概要を教えて」 · 「今四半期の最大の顧客は誰ですか？」 · 「前四半期のダッシュボードを作成して」
カレンダー	「今日の予定は何ですか？」 · 「今週の Maria とのミーティングを探して」
アカウント	「利用中の会社を教えて」 · 「別の Bookipi アカウントに切り替えて」 · 「ログアウトして」

CLI で構築する

スクリプト、自動化、自作のエージェント向けの、JSON を優先するコマンドラインツールです。Node 22.12 以降が必要で、ビルド手順はありません。

インストール（macOS/Linux）：最新リリースページからワンラインインストーラーを実行します。ダウンロードを検証し、~/.local/share/bookipi-cli にインストールして、~/.local/bin に bookipi を追加します。Node のインストールやシェルプロファイルの編集は行いません。更新するには、もう一度実行してください。

または、クローンから実行します。製品版のビルドは skills/bookipi-cli/bin/bookipi.js にあります。

git clone https://github.com/Bookipi-Group/bookipi-cli.git ~/bookipi-cli
alias bookipi=~/bookipi-cli/skills/bookipi-cli/bin/bookipi.js

使い方：

bookipi init                                   # create a workspace and sign in
bookipi invoice list --status overdue --json   # structured output

CI またはヘッドレス環境で使用する場合は、サインインの代わりに BOOKIPI_TOKEN を設定します。すぐに使えるスクリプト（期限超過の請求書への督促、Slack への週次ダイジェスト送信、領収書フォルダーから経費への登録）は examples/ にあります。

コマンド

すべてのコマンドで --json を指定できます。フラグは bookipi <group> --help で確認できます。

グループ	対象	サブコマンド
invoice	請求書と関連書類	list get preview create create-from-proposal duplicate update delete send send-receipt mark-paid void remind collections attach-photo
customer	顧客、支払い、メール	list get payments create update delete send-email emails
item	商品とサービス	list create set-photo
expense	経費と領収書のスキャン	categories list upload scan create delete
paylink	BPay 支払いリンク	create list get status send
deal	パイプラインの案件	list create update
proposal	AI が作成する提案書	list generate update duplicate send delete
contract	電子署名契約書	list draft upload create-from-proposal finalize send
report	レポート、ダッシュボード、インサイト	summary customers items dashboard insights digest suggest open
meeting	録画されたミーティングと予約	list
calendar	カレンダーの接続	status
company	現在の会社	list set
website	AI が構築する会社のウェブサイト	status content pages page create generate add-page update ask preview publish analytics open
—	セッションとワークスペース	setup login logout whoami init mcp

bookipi setup はエージェントが最初に呼び出すコマンドです。サインイン状況を確認し、必要であればサインインを開始して、次のステップを JSON で返します。

メール送信、支払いの記録または取り消し、支払いリンクの作成または送信、ウェブサイトの公開を行うコマンドは、--yes を指定しないと実行されません。チャットでは Claude が先に確認します。スクリプトでは自分で --yes を指定してください。

ヘルプとバグ報告

GitHub issue を作成し、依頼した内容、Claude の動作、期待していた結果をお知らせください。

セキュリティに関する問題： 非公開でご報告ください。SECURITY.md をご覧ください。

プライバシー

Bookipi CLI は、お客様ご自身の Bookipi アカウントを使用します。ポリシー全文： bookipi.com/privacy-policy。

• ビジネスデータ（請求書、顧客、経費、案件、提案書、契約書、ミーティング、ウェブサイト）は HTTPS 経由でお客様の Bookipi アカウントから読み書きされ、それ以外の場所には送信されません。
• サインイントークンは、お使いのマシンのワークスペース内にある .bookipi/ または ~/.bookipi/ に保存され、読み取りできるのはお客様だけです。トークンの送信先は Bookipi のサインインサービスのみです。bookipi logout を実行すると削除されます。
• 領収書とロゴの画像は、スキャンと請求書プレビューのために Bookipi の S3 ストレージにアップロードされます。
• 利用状況の分析データは Amplitude に送信されます。送信されるのは、実行されたコマンド、所要時間、失敗の有無、CLI のバージョン、OS、クライアントです。ユーザー識別には、メールアドレスまたはマシンの一方向ハッシュを使用します。引数、請求書の内容、顧客記録、認証情報が送信されることはありません。BOOKIPI_NO_ANALYTICS=1 または DO_NOT_TRACK=1 で無効にできます。
• アップデートの確認： CLI は 1 日に 1 回、最新リリースを確認するために GitHub に問い合わせます。送信されるのは CLI のバージョンのみです。BOOKIPI_NO_UPDATE_CHECK=1 で無効にできます。

ファイルをスキャンすることはありません（ワークスペースフォルダーと指定されたファイルのみを対象とします）。Claude との会話を収集することも、広告やモデルのトレーニングのためにデータを共有することもありません。ビジネスデータには Bookipi の保持ポリシーが適用されます。ローカルのサインイン情報は、ログアウトするまで保持されます。

ご質問やデータ削除のご依頼：[email protected]。

ライセンス

Copyright © Bookipi. All rights reserved — LICENSE をご覧ください。ご利用には Bookipi の利用規約が適用されます。