Serpmax Bulk Importer

Command-line utility for bulk-importing websites into your Serpmax.ru account from a plain text file.

Reads a list of URLs from websites.txt, runs an initial technical audit for each one via the API, and prints the result to the console. If one domain is invalid or unreachable — the script catches the error and continues with the rest.

⚠️ Availability notice: Serpmax is currently available for Russian users only. Payments are processed in RUB via Russian payment systems. API access is available on paid plans. 🌐 English version of the website: serpmax.ru/en

🇷🇺 Документация на русском

---

Requirements

• Python 3.10+
• requests 2.28+
• Serpmax API key — serpmax.ru/en/account-api

---

Installation

cd serpmax_importer
pip install -r requirements.txt

---

Configuration

1. Fill in the config in importer.py:

SERPMAX_API_KEY = "YOUR_SERPMAX_API_KEY"
FILE_PATH       = "websites.txt"

2. Fill in websites.txt — one site per line:

# This is a comment — line will be ignored

https://example.com
https://mysite.ru
another-site.org

Supported line formats:

• Full URL: https://example.com
• Domain without scheme: example.com → automatically becomes https://example.com
• Empty lines and lines starting with # — ignored

---

Usage

python importer.py

Example output:

============================================================
  Serpmax Bulk Importer
============================================================

Found 4 websites to import

[1/4] https://example.com
  ✅ Success — Audit ID: 1234 (queued)
[2/4] https://mysite.ru
  ✅ Success — Audit ID: 1235 (ready)
[3/4] https://broken-url
  ❌ API error [400]: Could not resolve host
[4/4] https://another-site.org
  ✅ Success — Audit ID: 1236 (queued)

============================================================
  Import complete.
  Success: 3  |  Errors: 1  |  Total: 4
============================================================

Status queued means the audit has been accepted and will be processed shortly. Results will appear in your dashboard at serpmax.ru/en.

---

Project Structure

serpmax_importer/
├── importer.py         # Main import script
├── serpmax_client.py   # Serpmax Python SDK
├── websites.txt        # List of websites to import
├── requirements.txt
└── README.md

---

License

MIT