UK Companies Finder

Веб-приложение на FastAPI для поиска зарегистрированных в Великобритании компаний через Companies House Advanced Company Search API с фильтрами по отрасли (SIC-коды) и региону, выводом таблицей и выгрузкой в Excel (.xlsx).

Возможности

• Фильтры: SIC-коды (отрасль), регион/город, диапазон дат регистрации, статус, ключевое слово в названии.
• Результаты с пагинацией (до 5000 записей).
• Таблица в браузере + кнопка «Выгрузить в Excel».

1. Получить API-ключ (бесплатно)

1. Зарегистрируйтесь на https://developer.company-information.service.gov.uk/
2. Создайте приложение и получите REST API key.

2. Установка

cd Dens_app
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Запуск

export COMPANIES_HOUSE_API_KEY=ваш_ключ
uvicorn main:app --reload

Откройте http://127.0.0.1:8000/

Пример

• SIC-коды: 62012, 62020 (разработка ПО / ИТ-консалтинг)
• Регион: London
• Зарегистрированы с: 2026-01-01
• Статус: active

→ получите список новых ИТ-компаний Лондона и выгрузите его в Excel.

Экспорт в Google Таблицы (настройка)

Кнопка «📊 В Google Таблицы» создаёт таблицу с результатами и открывает её. Нужен service account Google (один раз):

1. console.cloud.google.com → создать проект.
2. APIs & Services → Library → включить Google Sheets API и Google Drive API.
3. Credentials → Create credentials → Service account → создать.
4. У созданного аккаунта: Keys → Add key → JSON → скачать файл.
5. Передать ключ приложению:
   • локально: положить файл как service_account.json рядом с main.py;
   • на хостинге: задать переменную GOOGLE_SERVICE_ACCOUNT_JSON = всё содержимое JSON.

Таблица создаётся в Google Drive service account и расшаривается «по ссылке» (просмотр); если в форме указать email — он получит доступ редактора с уведомлением.

Без этой настройки приложение работает (поиск + Excel), просто кнопка Google покажет подсказку о настройке.

Как отправить приложение (в т.ч. на Chromebook)

⚠️ На Chromebook (Chrome OS) не запускаются .exe и обычные бинарники. Правильный способ — захостить приложение и отправить ссылку; получатель открывает её в Chrome и при желании устанавливает как приложение (иконка в лаунчере, двойной клик).

Шаг 1. Захостить (бесплатно, ~5 минут)

1. Залейте эту папку в репозиторий на GitHub.
2. Зайдите на https://render.com → New → Blueprint → выберите репозиторий (Render подхватит render.yaml).
3. (Необязательно) в Environment задайте COMPANIES_HOUSE_API_KEY — тогда получателю вообще не нужно вводить ключ.
4. Получите публичный адрес вида https://uk-companies-finder.onrender.com.

Альтернатива — Docker: docker build -t uk-companies . && docker run -p 8000:8000 -e COMPANIES_HOUSE_API_KEY=ключ uk-companies.

Шаг 2. Отправить

Отправьте ссылку получателю.

Шаг 3. Установка на Chromebook (PWA)

1. Открыть ссылку в Chrome.
2. В адресной строке справа нажать иконку «Установить» (или ⋮ → Установить приложение).
3. Приложение появится в лаунчере — запускается двойным кликом, как обычная программа.
4. Ввести API-ключ один раз в форме (сохранится в браузере), если он не задан на сервере.

Примечания

• API Companies House имеет лимит ~600 запросов / 5 минут. Приложение листает выдачу страницами по 100 записей.
• Поле location ищет по тексту адреса (город/регион), sic_codes — точное совпадение кодов.