Competitor Parser

Автоматический сбор и анализ данных о конкурентах в робототехнике из Google и базы знаний с выводом рейтинга, цен и адресов.

Security Scan

The SKILL.md claims to run a local Python scraper and interact with Google/Yandex/VK/Telegram, but the package contains no code and does not declare required credentials or clearly justify system-level actions — several inconsistencies that could lead to unexpected code execution or data exfiltration.

Purpose & Capability

The skill's stated purpose (collect competitor data) is plausible, but the SKILL.md lists files (competitors_scraper.py, data files, docs) that are not present in the package. It also suggests using Selenium+Chromium and accessing Yandex/2GIS/VK APIs — capabilities that would require additional binaries/credentials not declared by the skill.

Instruction Scope

Runtime instructions tell the agent/user to cd into a hardcoded path (/home/larthe/.openclaw/workspace) and run a local Python script that is not bundled. The doc recommends installing system packages (sudo apt-get install chromium), enabling browser automation, and shows a command that sends data via openclaw to a Telegram target. These steps involve reading local files, installing system software, and transmitting scraped data externally — none of which are constrained or accompanied by declared credentials or safeguards.

Install Mechanism

There is no install spec in the registry (instruction-only), which is low risk by itself. However, the instructions explicitly recommend installing Chromium/driver via apt-get and switching to Selenium, which requires privileged package installation and additional binaries on the host (manual, outside the package).

Credentials

The skill declares no required environment variables or credentials, yet the instructions say full parsing needs Yandex API keys, VK authorization, and implicit ability to send Telegram messages. Those credentials are not declared nor constrained, creating a mismatch and risk of ad-hoc secret usage or misconfiguration.

Persistence & Privilege

The skill does not request persistent/always-on privileges (always: false). Still, instructions encourage system package installation (sudo apt-get) and file I/O in a user workspace — actions that require elevated privileges or can modify the host. Autonomous invocation is allowed by default, so if the agent later is given the missing script, it could be executed without further review.

What to consider before installing

This package is just an instruction file that references a local Python scraper and other files which are not included. Do not run the suggested commands as-is. Before using: (1) request the missing competitors_scraper.py and related code and review it line-by-line; (2) confirm exactly which credentials (Yandex API key, VK token, Telegram channel/token) the skill needs and ensure they are only granted if necessary; (3) avoid running sudo apt-get or enabling browser automation on a production machine — test in an isolated VM/container; (4) be cautious about the openclaw message send example because it would transmit scraped data to an external Telegram target; (5) prefer a version of the skill that bundles code or points to a verifiable source (GitHub release) and that declares its required environment variables and install steps explicitly.

SKILL.md - Парсинг конкурентов

🎯 Назначение

Автоматический сбор и анализ данных о конкурентах в сфере робототехники.

---

🚀 Быстрый запуск

cd /home/larthe/.openclaw/workspace && python3 competitors_scraper.py

---

📊 Источники данных

Источник	Метод	Статус
Google Search	HTML парсинг	✅
Яндекс.Карты	HTTP запросы	⚠️
2ГИС	HTTP запросы	⚠️
VK	HTTP запросы	⚠️
База знаний	Встроенные данные	✅

---

📁 Файлы

Файл	Описание
competitors_scraper.py	Скрипт парсера
competitors_data.json	Полные данные (JSON)
competitors_data.csv	Таблица (CSV)
TELEGRAM-BOT-COMPETITORS.md	Инструкция для бота
COMPETITOR-PARSING.md	Техническая документация

---

🔧 Команды

Запуск парсинга

cd /home/larthe/.openclaw/workspace
python3 competitors_scraper.py

Чтение результатов

# JSON (полные данные)
cat competitors_data.json

# CSV (таблица)
cat competitors_data.csv

# Через jq (красивый вывод)
jq '.[].name' competitors_data.json

Проверка статуса

# Дата последнего обновления
stat competitors_data.json

# Количество записей
jq 'length' competitors_data.json

---

📤 Формат вывода

JSON структура

{
  "name": "Название компании",
  "address": "Адрес",
  "website": "Сайт",
  "phone": "Телефон",
  "price": "Цена",
  "rating": "Рейтинг",
  "vk": "Группа VK",
  "notes": "Примечание",
  "source": "Источник",
  "date": "Дата сбора"
}

---

💡 Сценарии использования

1. Быстрый анализ

Запрос: "Какие у нас конкуренты?"

Действия:

1. Запустить парсер
2. Прочитать JSON
3. Вывести ТОП-5 по рейтингу

2. Сравнение цен

Запрос: "Какие цены у конкурентов?"

Действия:

1. Извлечь цены из JSON
2. Посчитать мин/макс/среднее
3. Сгруппировать по сегментам

3. Анализ локаций

Запрос: "Где находятся конкуренты?"

Действия:

1. Извлечь адреса
2. Сгруппировать по районам
3. Показать на карте (текстово)

---

⚠️ Ограничения

Текущие

• Яндекс.Карты: требуется API для полного доступа
• 2ГИС: динамическая загрузка (нужен браузер)
• VK: требуется авторизация

Решения

Для полного парсинга:

sudo apt-get install -y chromium chromium-driver

Затем в скрипте:

• Раскомментировать init_browser()
• Использовать Selenium вместо requests

---

🎯 Примеры ответов

Успешный парсинг

✅ Парсинг завершён!

📈 Найдено: 6 конкурентов

🏆 ТОП-3 по рейтингу:
1. Кванториум ⭐4.9 — бесплатно/от 5000₽
2. Академия Робототехники ⭐4.8 — от 8000₽/мес
3. Роббо Клуб ⭐4.7 — от 7500₽/мес

💰 Средний ценник: 7000-8000₽/мес

📁 Отправить полный отчёт?

Если парсинг недоступен

⚠️ Прямой парсинг временно недоступен.

Но есть данные из базы знаний:

[6 конкурентов из get_known_competitors()]

Для полного парсинга нужна установка Chromium.

---

🔄 Обновление данных

Автоматически: при запросе пользователя

Вручную:

python3 competitors_scraper.py

Рекомендуется: обновлять раз в 1-2 недели

---

📞 Интеграция с Telegram

Отправка файла:

openclaw message send --channel telegram \
  --target "652766550" \
  --message "📊 Отчёт по конкурентам" \
  --media "/home/larthe/.openclaw/workspace/competitors_data.csv"

---

Версия: 1.0
Обновлено: 2026-03-22
Статус: ✅ Работает