店舗情報自動入力ツール / Store Information Auto-Fill Tool

🇯🇵 日本語 | 🇺🇸 English

---

Japanese

概要

エステサロンやビューティーサロンのサイテーション対策を効率化するChrome拡張機能です。エキテンとホットペッパービューティーの店舗登録フォームに、保存された店舗情報を自動入力します。

主な機能

• 対応サイト: エキテン（ekiten.jp）、ホットペッパービューティー（beauty.hotpepper.jp）
• 自動入力: 店舗名、郵便番号、住所、電話番号、メールアドレス、担当者名、建物名
• 郵便番号自動補完: エキテンで郵便番号入力後、自動で住所補完ボタンをクリック
• データ管理: Chrome拡張機能の設定画面で店舗情報を保存・編集
• 多言語対応: 英語の店舗名や住所を日本語に自動変換

インストール方法

1. このリポジトリをダウンロードまたはクローンします
2. Chromeブラウザで chrome://extensions/ を開きます
3. 右上の「デベロッパーモード」を有効にします
4. 「パッケージ化されていない拡張機能を読み込む」をクリック
5. ダウンロードしたフォルダを選択します

使用方法

初回設定

1. 拡張機能アイコンを右クリック → 「オプション」を選択
2. 店舗情報を入力します：
   • 店舗名
   • 郵便番号（7桁、ハイフンなし）
   • 都道府県
   • 市区町村
   • 住所（番地）
   • 建物名（任意）
   • 電話番号
   • メールアドレス
   • 担当者名
3. 「保存」ボタンをクリック

自動入力の実行

1. エキテンまたはホットペッパービューティーの店舗登録ページを開きます
2. 拡張機能アイコンをクリック
3. 「自動入力実行」ボタンをクリック
4. フォームに情報が自動入力されます

特別機能

エキテン専用最適化フロー

1. 郵便番号入力: 最初に郵便番号を入力
2. 自動住所補完: エキテンの「郵便番号から住所を自動入力」ボタンを自動クリック
3. その他項目入力: 住所補完後、残りの項目を入力
4. 住所上書き: 町名・番地フィールドは常に拡張機能の設定値で上書き

技術仕様

• Manifest Version: 3
• 対応ブラウザ: Chrome 100以降、Edge 100以降
• 権限: storage, activeTab
• データ保存: Chrome Storage API（ローカル保存）

ファイル構成

chrome_extension/
├── manifest.json          # 拡張機能設定ファイル
├── popup.html             # ポップアップUI
├── popup.js               # ポップアップロジック
├── options.html           # 設定画面UI
├── options.js             # 設定画面ロジック
├── content.js             # メインの自動入力ロジック
├── background.js          # バックグラウンドスクリプト
├── styles/
│   ├── popup.css         # ポップアップスタイル
│   └── options.css       # 設定画面スタイル
├── icons/                # 拡張機能アイコン
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── README.md             # このファイル

トラブルシューティング

よくある問題

Q: フィールドが見つからない

• A: サイトの構造が変更された可能性があります。ページを再読み込みして再試行してください。

Q: 郵便番号の自動補完が動作しない

• A: 郵便番号を7桁の数字（ハイフンなし）で入力していることを確認してください。

Q: 一部のフィールドが入力されない

• A: サイトによってフィールド構造が異なります。手動で残りの項目を入力してください。

開発者向け情報

カスタマイズ

新しいサイトに対応する場合は、content.jsのselectorsオブジェクトに新しいサイトのセレクターを追加してください。

デバッグ

開発者ツールのコンソールで、フォーム診断情報を確認できます。

ライセンス

このプロジェクトはMITライセンスの下で公開されています。

更新履歴

• v1.1.0: エキテン専用最適化フロー追加、コード最適化
• v1.0.0: 初回リリース

---

English

Overview

A Chrome extension designed to streamline citation building for beauty salons and esthetic salons. Automatically fills store registration forms on Ekiten and Hot Pepper Beauty with saved store information.

Key Features

• Supported Sites: Ekiten (ekiten.jp), Hot Pepper Beauty (beauty.hotpepper.jp)
• Auto-Fill: Store name, postal code, address, phone number, email, contact person, building name
• Postal Code Auto-Complete: For Ekiten, automatically clicks address auto-fill button after postal code entry
• Data Management: Save and edit store information through the extension's options page
• Multi-language Support: Automatically converts English store names and addresses to Japanese

Installation

1. Download or clone this repository
2. Open chrome://extensions/ in Chrome browser
3. Enable "Developer mode" in the top right
4. Click "Load unpacked extension"
5. Select the downloaded folder

Usage

Initial Setup

1. Right-click the extension icon → Select "Options"
2. Enter your store information:
   • Store name
   • Postal code (7 digits, no hyphens)
   • Prefecture
   • City/Municipality
   • Address (street number)
   • Building name (optional)
   • Phone number
   • Email address
   • Contact person name
3. Click "Save"

Running Auto-Fill

1. Open store registration page on Ekiten or Hot Pepper Beauty
2. Click the extension icon
3. Click "Execute Auto-Fill" button
4. Information will be automatically filled into the form

Special Features

Ekiten-Optimized Flow

1. Postal Code Entry: Enters postal code first
2. Auto Address Complete: Automatically clicks Ekiten's "Auto-fill address with postal code" button
3. Other Fields: Fills remaining fields after address completion
4. Address Override: Always overwrites the street address field with extension settings

Technical Specifications

• Manifest Version: 3
• Compatible Browsers: Chrome 100+, Edge 100+
• Permissions: storage, activeTab
• Data Storage: Chrome Storage API (local storage)

File Structure

chrome_extension/
├── manifest.json          # Extension configuration
├── popup.html             # Popup UI
├── popup.js               # Popup logic
├── options.html           # Options page UI
├── options.js             # Options page logic
├── content.js             # Main auto-fill logic
├── background.js          # Background script
├── styles/
│   ├── popup.css         # Popup styles
│   └── options.css       # Options page styles
├── icons/                # Extension icons
│   ├── icon16.png
│   ├── icon48.png
│   └── icon128.png
└── README.md             # This file

Troubleshooting

Common Issues

Q: Fields not found

• A: The site structure may have changed. Try reloading the page and retry.

Q: Postal code auto-complete not working

• A: Ensure postal code is entered as 7 digits without hyphens.

Q: Some fields not filled

• A: Field structures vary by site. Please manually fill remaining fields.

Developer Information

Customization

To add support for new sites, add new site selectors to the selectors object in content.js.

Debugging

Form diagnosis information is available in the browser developer tools console.

License

This project is released under the MIT License.

Version History

• v1.1.0: Added Ekiten-optimized flow, code optimization
• v1.0.0: Initial release

---

Contributing

We welcome contributions! Please feel free to submit issues and pull requests.

Development Setup

1. Clone the repository
2. Load the extension in Chrome developer mode
3. Make changes to the code
4. Test on target websites
5. Submit a pull request

---

Support

If you encounter any issues or have questions, please open an issue on GitHub.