excel-data-bridge

KO | EN

gitlite — search

#hacktoberfest #react #llm #deep-learning #linux #docker #java #nodejs #windows #kubernetes #pytorch #security #ios #mcp

excel-data-bridge

(★ 9)

A simple local Python proxy server to import live data (e.g., currency rates) from modern websites into Microsoft Excel, bypassing web protections like Cloudflare

excel-data-bridge Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Excel Data Bridge 🌉

Простой локальный прокси-сервер на Python для импорта актуальных данных (например, курсов валют) с современных сайтов в Microsoft Excel в обход веб-защит.

---

### 🎯 Проблема: Excel больше не может "достучаться" до данных на сайтах

Многие инвесторы и аналитики любят вести учёт в Excel. Это удобно, привычно и бесплатно. Однако у Excel есть фундаментальная проблема: его встроенная функция `ВЕБСЛУЖБА` (`WEBSERVICE`) не справляется с современными сайтами.

Почему так происходит?
1.  **Динамический контент:** cайты стали веб-приложениями, где данные подгружаются скриптами (JavaScript). Excel не умеет исполнять эти скрипты и получает лишь "пустой" скелет страницы.
2.  **Продвинутая защита:** cервисы вроде Cloudflare блокируют простые автоматизированные запросы, которыми и являются запросы из Excel. Они требуют прохождения проверок, которые Excel выполнить не может.

В итоге, попытка получить курс валют или котировку акции простой формулой чаще всего заканчивается ошибкой.

### 💡 Решение: локальный "умный посредник"

**Excel Data Bridge** решает эту проблему, выступая в роли моста между вашей Excel-таблицей и интернетом. Вы устанавливаете на свой компьютер небольшую программу, которая умеет вести себя как настоящий браузер: обходить защиты, выполнять скрипты и извлекать нужные данные в чистом виде.

**Схема работы:**

```
┌───────────────────┐      ┌──────────────────────┐      ┌──────────────────┐
│ 1. Excel (формула)│─ ─ ─>│ 2. Локальный сервер  │─ ─ ─>│ 3. Сайт-источник │
│ (простой запрос)  │      │  (Excel Data Bridge) │      │  (investing.com) │
└───────────────────┘      └────────┬─────────────┘      └─────────┬────────┘
        ▲                           │                              │
        │                           │ (обрабатывает данные)        │ (получает "сырые" данные)
        └───────────────────────────┴──────────────────────────────┘
                    (возвращает готовый результат)
```

Вам не нужно вникать в сложности веб-технологий. Вы просто используете знакомую формулу в Excel, а вся "магия" происходит локально на вашем ПК.

![](https://github.com/empenoso/excel-data-bridge/blob/main/Screenshot.png)

### ✨ Возможности

*   **Получение данных с защищённых сайтов:** встроенный механизм `cloudscraper` имитирует поведение браузера для обхода защиты Cloudflare.
*   **Простота установки:** никаких сложных настроек. Весь процесс сводится к запуску двух файлов.
*   **Без плагинов и макросов:** работает со стандартной функцией Excel `ВЕБСЛУЖБА`. Не требует изменения настроек безопасности.
*   **Лёгкость и скорость:** использует современный и быстрый фреймворк FastAPI.
*   **Гибкость:** возвращает данные в разных форматах (текст, JSON, XML) для любых нужд.

### 🚀 Быстрый старт

Для начала работы вам понадобится установленный **Python**. Если у вас его нет, скачайте с [официального сайта python.org](https://www.python.org/downloads/).

**Шаг 1: Скачайте файлы репозитория**

Нажмите зелёную кнопку `<> Code` вверху страницы и выберите `Download ZIP`. Распакуйте архив в удобное для вас место, например, в папку `C:\excel-data-bridge`.

В этой папке должны находиться четыре файла:
*   `investing_proxy.py` — основной скрипт сервера.
*   `requirements.txt` — список необходимых библиотек.
*   `1_install_requirements.bat` — установщик зависимостей.
*   `2_start_server.bat` — скрипт для запуска сервера.

**Шаг 2: Установите зависимости**

Дважды кликните по файлу `1_install_requirements.bat`. Откроется окно командной строки, где автоматически установятся все нужные компоненты. Дождитесь сообщения `Установка завершена!` и нажмите любую клавишу.

**Шаг 3: Запустите сервер**

Дважды кликните по файлу `2_start_server.bat`. Откроется новое окно командной строки. **Не закрывайте это окно!** Пока оно открыто, ваш локальный сервер работает и готов принимать запросы от Excel.

**Шаг 4: Получите данные в Excel**

Откройте Microsoft Excel и используйте функцию `ВЕБСЛУЖБА` для обращения к вашему локальному серверу.

*   Чтобы получить **курс USD/RUB**, введите в ячейку:
    ```excel
    =ВЕБСЛУЖБА("http://localhost:8000/usd_rub/rate")
    ```
*   Чтобы получить **дату и время** котировки, введите в соседнюю ячейку:
    ```excel
    =ВЕБСЛУЖБА("http://localhost:8000/usd_rub/datetime")
    ```

Результат появится в ячейке через несколько секунд!

### ⚙️ Доступные API (Endpoints)

Сервер предоставляет несколько адресов (endpoints) для получения данных в разных форматах.

| Адрес (Endpoint)                                | Описание                                                              | Пример формулы в Excel                                             |
| ----------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------ |
| `/usd_rub/rate`                                 | **Курс** в текстовом формате (с запятой, `92,55`)                     | `=ВЕБСЛУЖБА("http://localhost:8000/usd_rub/rate")`                  |
| `/usd_rub/datetime`                             | **Дата и время** котировки в текстовом виде (`2025-09-07 15:30:00`)   | `=ВЕБСЛУЖБА("http://localhost:8000/usd_rub/datetime")`              |
| `/usd_rub/timestamp`                            | **Дата и время** в формате числа Excel (для расчётов)                 | `=ВЕБСЛУЖБА("http://localhost:8000/usd_rub/timestamp")`             |
| `/usd_rub/rate/en`                              | Курс в "английском" формате (с точкой, `92.55`)                       | `=ВЕБСЛУЖБА("http://localhost:8000/usd_rub/rate/en")`               |
| `/usd_rub`                                      | Все данные в формате **JSON**                                         | Не используется напрямую в ячейке.                                 |
| `/usd_rub/xml`                                  | Все данные в формате **XML**                                          | `=ФИЛЬТР.XML(ВЕБСЛУЖБА("http://localhost:8000/usd_rub/xml");"//rate")` |
| `/status`                                       | Статус работы сервера                                                 | `=ВЕБСЛУЖБА("http://localhost:8000/status")`                       |

### ⚖️ Дисклеймер

Данный проект создан **исключительно в образовательных и исследовательских целях** для демонстрации работы с публичными API и веб-технологиями. Автор не призывает и не рекомендует использовать его для нарушения правил каких-либо сайтов.

Этот код предоставляется "КАК ЕСТЬ", без каких-либо гарантий. Использование кода означает согласие с условиями и принятие полной ответственности за его применение. Всегда соблюдайте условия использования веб-ресурсов и применимое законодательство.

### 👤 Автор

*   **Автор:** Михаил Шардин
*   **Онлайн-визитка:** [shardin.name](https://shardin.name/?utm_source=github)
*   **Telegram-канал:** ["Умный Дом Инвестора"](https://t.me/+asaEcPax8o41MjQy)

### 📜 Лицензия

Проект распространяется под лицензией MIT. Подробности в файле `LICENSE`.

excel-data-bridge

excel-data-bridge Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

excel-data-bridge

excel-data-bridge Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README