SkillHub — Мультиплатформенный агент для перепродажи

SkillHub — это набор из 8 навыков (skills) для Claude Code + MCP-сервер, реализующий «умного агента по перепродаже» (Smart Resale Agent). Он помогает выкладывать и перепродавать товары на вторичных площадках (C2C) с минимальным участием человека: от распознавания фото до авто-делистинга при продаже. Версия v2 работает как стандартный MCP-сервер (JSON-RPC через stdio), совместимый с Claude Desktop, Cursor, VS Code или веб-интерфейсами.

Архитектура

skillhub/
├── broker_core/              # Общий движок (pip install -e .)
│   ├── session_manager.py    # Логин в браузере → сохранение куки
│   ├── platform_client.py    # Авторизованные клиенты API площадок
│   ├── state_manager.py      # Состояние листингов (~/.broker/listings.json)
│   ├── scheduler.py          # Регистрация launchd (macOS) / cron (Linux)
│   ├── audit_logger.py       # Аудит с неизменяемым логом (~/.broker/audit.jsonl)
│   └── mcp_server.py         # ★ MCP-сервер — 7 инструментов через JSON-RPC
├── guardrails/               # Фреймворк промтов (v2): Omni-Agent-Guardrails.yaml
├── skills/                   # 8 навыков Claude Code
│   ├── personal-broker/      # Оркестратор семи шагов
│   ├── broker-recognize/     # Шаг 1: Фото → структурированная информация о товаре
│   ├── broker-auth/          # Шаг 2: Привязка аккаунтов площадок
│   ├── broker-price/         # Шаг 3: Исследование цен (с авторизацией)
│   ├── broker-fuse/          # Шаг 4: Price Shield (минимальная цена)
│   ├── broker-card/          # Шаг 5: Генерация карточек + публикация
│   ├── broker-schedule/      # Шаг 6: Настройка расписания репрайсинга
│   └── broker-delist/        # Шаг 7: Автоделистинг при продаже
├── tests/                    # 41 тест
└── docs/                     # Гайды по настройке MCP-клиентов

Конвейер из 7 шагов

1. broker-recognize — загрузка фото, распознавание товара (Claude Vision)
2. broker-auth — открытие браузера, однократный логин на площадки
3. broker-price — поиск аналогов с учётом авторизации → отчёт о ценах
4. broker-fuse — ⚠️ установка минимальной цены (floor price) ДО публикации
5. broker-card — создание карточек, проверка floor price, подтверждение пользователем → автопубликация
6. broker-schedule — настройка launchd/cron для ежедневной проверки цен (с защитой floor)
7. broker-delist — детект продажи → авто-удаление со всех площадок (без подтверждения)

Каждый навык можно вызвать отдельно (например, /broker-price только для анализа цен).

Требования

• Python 3.9+
• Playwright (для авторизации на площадках): pip install playwright && playwright install chromium
• ANTHROPIC_API_KEY (обязателен для фото-распознавания): export ANTHROPIC_API_KEY='sk-ant-...'

Быстрый старт

Путь A: Claude Desktop (рекомендуется, 5 минут)

1. Установите:

git clone https://github.com/madguyevans-creator/skillhub.git
cd skillhub && pip install -e .
pip install playwright && playwright install chromium

1. Получите API-ключ: перейдите на console.anthropic.com → API Keys → создайте ключ. Сохраните:

echo 'sk-ant-your-key' > ~/.broker/api_key

1. Настройте Claude Desktop: добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "skillhub": {
      "command": "python3",
      "args": ["/path/to/skillhub/broker_core/mcp_server.php"],
      "env": {"BROKER_MOCK_MODE": "true"}
    }
  }
}

1. Перезапустите Claude Desktop. Готово!

Пример использования: скажите «Продай эти кроссовки» и приложите фото. Claude автоматически вызовет 7 MCP-инструментов в правильном порядке.

Путь B: Claude Code CLI

git clone https://github.com/madguyevans-creator/skillhub.git
cd skillhub && pip install -e .
cp -r skills/* ~/.claude/skills/

Затем внутри Claude Code используйте команды: /personal-broker (полный конвейер), /broker-recognize, /broker-price, /broker-fuse.

Путь C: Демо без аккаунтов (режим моков)

По умолчанию BROKER_MOCK_MODE=true — всё работает с симулированными данными. Никаких API-ключей и реальных площадок не нужно. Распознавание фото возвращает демо-кроссовки Nike.

git clone ... && cd skillhub && pip install -e .
# Готово — можно использовать Путь A или B

Реальный режим: отключение моков

export BROKER_MOCK_MODE=false
python3 skills/broker-auth/scripts/auth.py --all

Откроется браузер — войдите на каждую площадку один раз. Куки сохраняются.

Режим песочницы / Mock Mode

По умолчанию BROKER_MOCK_MODE=true — все вызовы API (поиск, публикация, делистинг) возвращают реалистичные симулированные данные. Никаких реальных HTTP-запросов. Это позволяет:

• Демонстрировать полный конвейер без аккаунтов
• Безопасно разрабатывать — никакого риска случайной публикации
• Избегать блокировок и CAPTCHA

Для работы с реальными API установите BROKER_MOCK_MODE=false и привяжите аккаунты через broker-auth.

Прозрачный аудит (Transparency Log)

Каждое решение агента записывается в ~/.broker/audit.jsonl — неизменяемый лог в формате JSONL. Вы всегда можете проверить, что и почему сделал агент.

Что логируется: результаты исследования цен, проверки Price Shield (заблокировано/разрешено), публикации, репрайсинг, делистинг, регистрация расписаний.

Как просмотреть:

from broker_core import audit_logger
print(audit_logger.format_trail('item_abc123'))  # Человекочитаемая хронология
trail = audit_logger.get_audit_trail('item_abc123')  # JSON-массив

Ключевые проектные решения

Лицензия

MIT — подробнее в LICENSE