インストール
システム要件
- Python: 3.8以上
- OS: Windows / macOS / Linux
- メモリ: 2GB以上推奨
- ディスク容量: 500MB以上
インストール手順
-
Pythonのインストール確認
python --version
Python 3.8以上がインストールされているか確認します。
-
ツールのダウンロード
git clone https://github.com/your-repo/real-estate-flyer-tool.git
cd real-estate-flyer-tool
GitHubからツールをダウンロードします。
-
依存関係のインストール
pip install -r requirements.txt
必要なPythonライブラリをインストールします。
-
セットアップスクリプトの実行
python setup.py
自動セットアップを実行し、動作確認を行います。
ヒント
インストール時間は約5分です。setup.pyが成功すれば、すぐに使い始められます。
基本的な使い方
最もシンプルな使い方
PDFファイルからマイソクを生成する最も簡単な方法です。
python real_estate_flyer_generator.py 登記簿.pdf
これだけで、自動的にマイソクPDFが生成されます。出力ファイル名は自動で決定されます。
出力ファイル名を指定
python real_estate_flyer_generator.py 登記簿.pdf -o マイソク.pdf
追加パラメータの指定
python real_estate_flyer_generator.py 登記簿.pdf \
--price "2,500万円" \
--type "マンション" \
--remarks "駅徒歩5分"
注意
登記簿PDFのファイル名に日本語や特殊文字が含まれる場合、引用符で囲んでください。
Web版の使い方
Webサーバーの起動
python enhanced_web_interface.py
ブラウザで http://localhost:5000 にアクセスします。
操作手順
-
登記簿PDFをアップロード
「PDFファイルを選択」ボタンをクリックするか、ファイルをドラッグ&ドロップします。
-
自動解析結果を確認
アップロード後、自動的に物件情報が抽出されます。各フィールドの内容を確認してください。
-
データを編集
必要に応じて、所在地・面積・価格などを手動で修正します。
-
画像を追加
「画像を選択」から最大8枚の物件画像をアップロードします。複数選択可能です。
-
プレビュー確認
「プレビュー」ボタンで生成前の仕上がりを確認できます。
-
マイソク生成
「マイソク生成」ボタンをクリックし、PDFをダウンロードします。
ヒント
Web版は初心者に最適です。視覚的に操作でき、リアルタイムでエラーチェックも行われます。
CLI版の使い方
インタラクティブエディターの起動
python interactive_editor.py 登記簿.pdf
メニュー操作
起動後、以下のメニューが表示されます：
==================================================
不動産マイソク インタラクティブエディター
==================================================
1. 📋 基本情報を編集
2. 💰 価格情報を編集
3. 📝 備考を編集
4. 📷 画像を追加/管理
5. 👁️ プレビュー
6. 💾 JSONファイルに保存
7. 📂 JSONファイルから読み込み
8. ✅ マイソクを生成
9. 🚪 終了
選択してください (1-9):
各メニューの説明
- 1. 基本情報編集: 所在地、面積、構造などを個別に編集
- 2. 価格情報編集: 価格、管理費、その他費用を設定
- 3. 備考編集: 自由記述欄の編集
- 4. 画像管理: 画像パスの追加・削除
- 5. プレビュー: 現在のデータ内容を確認
- 6. 保存: 編集内容をJSONで保存
- 7. 読込: 保存したJSONファイルから復元
- 8. 生成: マイソクPDFを作成
上級者向け
CLI版はバッチ処理やスクリプト化に最適です。JSONファイルを使えば、同じ設定を複数の物件に適用できます。
高度な機能
データ管理
作成したマイソクの履歴管理やテンプレート機能を活用できます。
履歴確認
python data_manager.py history
統計表示
python data_manager.py stats
バックアップ作成
python data_manager.py backup --backup-path backup.zip
復元
python data_manager.py restore --backup-path backup.zip
テンプレート機能
物件種別ごとにテンプレートを保存し、再利用できます。
# テンプレート保存
python data_manager.py save-template \
--name "マンションテンプレート" \
--type "マンション"
# テンプレート読込
python data_manager.py load-template \
--name "マンションテンプレート"
バッチ処理
複数のPDFを一括処理することもできます。
#!/bin/bash
# 複数ファイルの一括処理
for pdf in *.pdf; do
python real_estate_flyer_generator.py "$pdf"
done
活用例
大量の物件を扱う場合、テンプレートとバッチ処理を組み合わせると効率的です。
トラブルシューティング
よくある問題と解決方法
問題: 「ModuleNotFoundError」が表示される
原因: 必要なライブラリがインストールされていません。
解決方法:
pip install -r requirements.txt
問題: PDF解析でデータが抽出されない
原因: 登記簿PDFのフォーマットが標準と異なる可能性があります。
解決方法:
- Web版またはインタラクティブエディターで手動入力してください。
- config.pyの正規表現パターンをカスタマイズすることも可能です。
問題: 日本語フォントが表示されない
原因: システムに日本語フォントがインストールされていません。
解決方法:
# Ubuntu/Debian
sudo apt-get install fonts-noto-cjk
# macOS（通常は不要）
# Windowsの場合、Noto Sans CJKをダウンロード・インストール
問題: 画像が表示されない
原因: 画像ファイルのパスが間違っているか、対応していない形式です。
解決方法:
- 画像ファイルのパスを確認してください（絶対パスまたは相対パス）。
- JPEG/PNG形式のみ対応しています。他の形式は変換してください。
問題: Webサーバーが起動しない
原因: ポート5000が既に使用されています。
解決方法:
# 別のポートを指定
python enhanced_web_interface.py --port 8080
それでも解決しない場合
FAQページを確認するか、GitHubのIssuesで質問してください。コミュニティがサポートします。