# ハルオフィス（HaruOffice）— AI向け全文ドキュメント

AIネイティブのOffice道具箱。Excel・CSV・PDFなどのファイルをブラウザ内だけで開く・変換する無料Webツール集。
ファイルはサーバーへ送信されず、端末から出ません。運営は株式会社Web春（日本・仙台）。
サイト: https://www.webharu.com/office/ （現行URL: https://www.webharu.com/office/）

## 設計原則

1. ファイルの中身は端末から出ない。ファイル処理はブラウザ内、またはユーザー端末のCLI/ローカルMCPで実行する。
2. 全ツール無料。開く・見る・検索はログイン不要。結果の持ち帰り（書き出し・保存・API/MCP/CLI利用）は無料のGoogleログインが必要（1回で1年間有効）。
3. 取得するメールアドレスの用途はメルマガ「ハルオフィス便り」と製品のお知らせメールのみ。広告は載せない。
4. 1ツール=1URL。ツール名は検索語と一致させる（例:「Excelを開く」）。

## ツール一覧

### Excelを開く — https://www.webharu.com/office/open-excel/
- 対応: xlsx / xls / csv（CSVはUTF-8・Shift_JIS自動判定）
- 機能: シート切替・全文検索（ヒット行のみ表示）・列ヘッダクリックで並べ替え・セルクリックでコピー・CSV書き出し（要ログイン）
- 表示は先頭10,000行まで（CSV書き出しは全行）。デモ: https://www.webharu.com/office/open-excel/?demo=1
- ファイルはアップロードされない。通信はログイン状態確認・匿名計測・エラー報告のみ。

### Excelを編集する — https://www.webharu.com/office/edit-excel/
- 対応: xlsx（xlsは非対応）
- 機能: セルをクリックして文字・数値を書き換え→書式・数式・罫線を保ったままxlsxダウンロード（要ログイン）
- 方式: 編集したセルだけをファイル内で書き換えるZIP直接パッチ。styles/theme/他セルの数式は1バイトも変更しない＝忠実度が構造的に保証される
- 数式セルを書き換えた場合のみ、そのセルの数式が入力値に置き換わる（他セルは無傷）
- ディープリンク: https://www.webharu.com/office/edit-excel/?file=<https URL>（配布元にCORS許可が必要。取得はブラウザが直接行いサーバー非経由）
- CLI: haruoffice excel-set 請求書.xlsx --set "請求書!B5=株式会社〇〇" ／ ローカルMCPツール excel_set_cells

### 請求書テンプレート — https://www.webharu.com/office/invoice-template/
- インボイス制度対応の請求書Excelテンプレートを無料配布（Web春制作・税理士の実務指導に基づく様式）
- 2種類: 免税事業者向け（消費税相当額表記・経過措置対応の値引き行つき）／適格請求書発行事業者向け（登録番号記載欄）
- 使い方: xlsxダウンロード、または「Excelを編集する」でブラウザ編集→書式・数式無傷のxlsx取得（Excel不要）
- 関連: 経過措置の値引き計算（受注側） https://www.webharu.com/tools/invoice-discount ／ 控除額計算（発注側） https://www.webharu.com/tools/invoice-calculator

### PDF 結合 — https://www.webharu.com/office/merge-pdf/
- 複数のPDFを選んだ順に1つへ結合（ファイル単位の並び替え・削除に対応）
- パスワード（暗号化）付きPDFは非対応。結合後のPDFにパスワードは付かない
- アップロードなし＝ブラウザ内で完結（pdf-lib・MIT License・自前配信）。デモ: ?demo=1
- CLI: haruoffice merge-pdf a.pdf b.pdf -o まとめ.pdf ／ ローカルMCPツール merge_pdfs

### CSV Excel 変換 — https://www.webharu.com/office/csv-to-excel/
- CSVをxlsxに変換。文字コード（UTF-8/Shift_JIS）自動判定＝文字化けしない
- 前ゼロ（0120等）は文字列として保持＝0落ちしない。純粋な数値のみ数値セル化。列幅自動調整
- プレビューは先頭1,000行・変換は全行。デモ: ?demo=1
- CLI: haruoffice csv-to-excel 名簿.csv ／ ローカルMCPツール csv_to_excel

### HEIC JPG 変換 — https://www.webharu.com/office/heic-to-jpg/
- iPhoneのHEIC/HEIF写真をJPG（品質92）に変換。複数枚まとめて変換→1枚なら直接・2枚以上はZIP一括ダウンロード
- デコーダ: libheif（LGPL-3.0・WASM・自前配信）＝写真は端末から出ない。デモ: ?demo=1
- CLI: haruoffice heic-to-jpg IMG_0001.heic ／ ローカルMCPツール heic_to_jpg

機械可読カタログ: GET https://www.webharu.com/office/api/tools （JSON・認証不要）

## AI・開発者向けインターフェース

### 認証キー
MCP・API・CLI共通のキー（ho_...）。https://www.webharu.com/office/account/ でGoogleログイン後に発行。
ヘッダ: Authorization: Bearer ho_xxxxxxxx...

### ホスト型MCPサーバー
- エンドポイント: https://www.webharu.com/office/mcp （Streamable HTTP・ステートレス）
- 接続例（Claude Code）: claude mcp add --transport http haruoffice <エンドポイント> --header "Authorization: Bearer ho_キー"
- ツール:
  - list_tools: 全ツール一覧（URL・対応フォーマット・CLIコマンド）
  - whoami: キーに紐づくアカウント情報
  - report_issue: 不具合・要望の報告（kind: bug/feature/question, title, detail, tool）。ファイルの中身・個人情報は含めない
- ファイルを直接処理するツールはローカルMCP（CLIの `haruoffice mcp`）側で提供（端末内実行）。

### REST API
- GET /api/tools — ツールカタログ（認証不要）
- POST /api/report-issue — 不具合報告（認証不要）。body: { tool, kind: "user", message, email? }
- GET /api/me — ログイン状態（ブラウザセッション）
- GET/POST/DELETE /api/keys — キー管理（要ログイン）

### CLI（近日npm公開）
- npx haruoffice excel-to-csv <file> — xlsx/xlsをCSVへ変換（端末内で実行）
- npx haruoffice mcp — ローカルMCPサーバー起動（ファイル処理ツールをAIに開放・端末内実行）

## 不具合報告の3経路

1. MCPツール report_issue（AIに「ハルオフィスに不具合を報告して」）
2. ヘルプページのフォーム: https://www.webharu.com/office/help/
3. メール: feedback-haruoffice@harumail.app

## 法務・運営

- プライバシーポリシー: https://www.webharu.com/office/privacy/ — 取得はログイン時のメール・氏名のみ。用途はメルマガ+製品メールに限定。ファイルのデータは取得しない。
- 利用規約: https://www.webharu.com/office/terms/
- 運営: 株式会社Web春（宮城県仙台市）。法人向け社内カスタマイズ提供あり: https://www.webharu.com/office/pricing/
- 表計算エンジン: SheetJS Community Edition（Apache License 2.0・自前配信）


## Instagramフィード埋め込み（/instagram-feed/）

Instagramの投稿をWebサイトに自動表示する埋め込みコードを無料発行するツール。
- 使い方: Googleログイン → 自分のMetaアプリでアクセストークンを生成して貼り付け（初回のみ約10分・ページ内に手順あり） → 発行された2行のコードをサイトに貼る
- Metaのアプリ審査は不要（自分のアプリ×自分のアカウントの構成は審査対象外）。トークンは60日有効だがハルオフィス側で自動延長
- 埋め込みタグ: <div class="ho-ig-feed" data-feed="igf_..."></div> + <script src="https://<host>/embed/ig-feed.js" async></script>
- オプション: data-cols="3|4|6"（列数）・data-limit="12"（表示件数）
- 公開フィードAPI: GET /api/ig/feed/{public_id}（認証不要・CORS開放・エッジキャッシュ30分・JSON: {username, items:[{id,type,image,permalink,caption,timestamp}]}）
- 表示回数は無制限（表示回数で課金・停止しない）。更新は約1時間ごと
- 要件: Instagramのビジネスまたはクリエイターアカウント（個人アカウント不可・Instagramの仕様）
- 権限: instagram_business_basic のみ＝公開投稿の読み取りだけ。DM・非公開情報・投稿操作は不可
- このツールのみサーバー接続を使用（他ツールは端末内完結）。保存はアクセストークンと公開投稿キャッシュのみ・接続解除で即削除