QStrader - AI Trading Assistant

AI Trading Assistant for quantumstocks.ru. Automated hedge fund with market analysis, risk management, and trade execution via n8n MCP. Use when analyzing ma...

Security Scan

The skill's code and instructions align with a trading assistant, but the registry metadata omits required credentials and runtime assumptions and the skill can call broker write endpoints (orders) with no technical enforcement of user confirmation — proceed only after manual review and tightening of credentials/agent permissions.

Purpose & Capability

The skill claims to be a trading assistant using n8n MCP, which matches the code (mcporter calls, risk checks, logging). However the registry metadata declares no required environment variables or binaries even though SKILL.md and scripts expect .env entries (N8N_MCP_URL, QDRANT_URL, QDRANT_API_KEY, LIGHTRAG_USERNAME/PASSWORD, OPENROUTER_API_KEY) and require 'mcporter' and Python. This mismatch between declared requirements and actual needs is an incoherence.

Instruction Scope

SKILL.md and scripts instruct the agent to call many MCP endpoints including write endpoints (Place_Order, Close_an_open_deal). The documentation insists on human confirmation for writes, but nothing in the code enforces interactive confirmation — the agent or an automated workflow could call Place_Order if prompted. Scripts also read local mcporter config files (~/.openclaw/workspace/config/mcporter.json and similar) and reference instrument.json paths, which gives access to existing configured broker connections and their credentials if present.

Install Mechanism

There is no formal install spec (instruction-only), which lowers install-time risk. setup.sh is provided and suggests installing mcporter via npm; the skill will instruct users to run that script. No remote downloads or obfuscated installers are present in the package, but running setup.sh or the suggested npm install will modify the host environment and may register MCP endpoints.

Credentials

The package expects multiple secrets and endpoints (.env.example lists N8N_MCP_URL, QDRANT_URL/KEY, LightRAG creds, OPENROUTER_API_KEY) yet the skill metadata declares none. Requesting broker/control endpoints and database/LLM keys is reasonable for this purpose, but those are sensitive credentials and their absence from the declared requirements is misleading and reduces the ability to evaluate privilege scope before install.

Persistence & Privilege

always:false and normal model invocation behavior — no forced permanent inclusion. setup.sh may add a mcporter config entry (mcporter add my-n8n-mcp) into the user's mcporter configuration which is expected. The combination of autonomous invocation (platform default) plus the skill's ability to call write endpoints is worth attention, but autonomous invocation alone is not a disqualifier.

What to consider before installing

This skill appears to implement what it claims (market analysis, risk checks, and mcporter-based trading), but there are important mismatches and operational risks you should address before installing: 1) Metadata mismatch: The skill DOES expect and instruct you to populate a .env with N8N_MCP_URL, QDRANT and LightRAG credentials, and an OpenRouter key, yet the registry lists no required env vars. Don’t assume the registry has enumerated needed secrets — inspect and populate .env yourself. 2) Broker write ability: The skill can call Place_Order and other write endpoints via mcporter. SKILL.md asks for human confirmation, but the code does not technically enforce an interactive confirmation step. If you allow autonomous agent actions, an agent could place live orders. Limit agent autonomy or require an explicit, auditable manual confirmation step before any write call. 3) mcporter config and scope: The scripts auto-detect and use existing mcporter config files (~/.openclaw/workspace/config/mcporter.json, ~/.mcporter/mcporter.json). Before running, inspect those files to ensure they reference only broker/MCP endpoints you control; otherwise the skill could use pre-existing credentials unintentionally. 4) Run in a safe environment: Test thoroughly in a sandbox or paper-trading account (n8n MCP test/demo) before connecting to live brokers. Verify risk_manager behavior (it returns non-zero on rejection) and that your operational process prevents accidental live orders. 5) Review .env.example and sources: Fill only the minimal credentials required, rotate keys used for testing, and avoid putting high-privilege production keys into the skill until tested. Consider restricting OPENROUTER/QDRANT keys to limited-scope/test projects. 6) Operational checks: If you intend to use this skill, update the registry metadata to list required env vars and required binaries (mcporter, python3). Add or demand a programmatic confirmation step (or disable autonomous invocation) before write endpoints are called. If you want, I can produce a checklist you can run before enabling the skill or suggest a minimal .env and a safe confirmation wrapper to enforce manual approval.

QStrader — Торговый ассистент AI хедж-фонда

Архитектура

QStrader работает через n8n MCP — единый торговый терминал с 45+ инструментами. Доступ к MCP осуществляется через mcporter CLI или напрямую через MCP.

Пользователь → Агент → mcporter call → n8n MCP → Брокер / Данные

⚠️ Правила безопасности (критично!)

1. SL/TP обязательно — ни одной позиции без стоп-лосса и тейк-профита
2. Margin < 50% — если больше, немедленно закрываем худшие позиции
3. Дневной убыток < 2% — превысил → стоп торговли на день
4. Числа проверяй дважды — ошибка 640 вместо 6400 стоит дорого
5. Защита > атака — закрытие убыточных позиций приоритетнее открытия новых
6. Только с подтверждения — любой ордер требует согласия пользователя

Подробнее: references/risk-rules.md

Workflow: Анализ перед входом в сделку

Шаг 1. Получить данные аккаунта

mcporter call my-n8n-mcp.Get_account_data

Проверить: баланс, маржа, свободные средства.

Шаг 2. Технический анализ

mcporter call my-n8n-mcp.get_technical_analysis ticker=^GSPC

Как читать индикаторы:

• RSI (0-100): <30 — перепроданность (pot buy), >70 — перекупленность (pot sell)
• MACD: MACD > Signal → бычий, MACD < Signal → медвежий. Гистограмма показывает momentum
• Bollinger Bands: цена у верхней полосы → перекуплен, у нижней → перепродан
• EMA 9/21: EMA9 > EMA21 → uptrend, EMA9 < EMA21 → downtrend

Шаг 3. LSTM прогноз

mcporter call my-n8n-mcp.predict_future_price_lstm ticker=^GSPC start_date=2025-04-27-00-00 end_date=2026-03-28-00-00 interval=1h future_steps=10 time_step=512

• start_date: ~11 месяцев назад (YYYY-MM-DD-HH-MM)
• end_date: завтра
• future_steps: количество будущих баров для прогноза
• time_step: длина обучающего окна

Обратить внимание на: VaR, рекомендованные стоп-лоссы, направление прогноза.

Шаг 4. Новости и сентимент

mcporter call my-n8n-mcp.CNBC_news input="S&P 500"
mcporter call my-n8n-mcp.BBG_market input="stocks"

Шаг 5. Проверка risk limits

Используй scripts/risk_manager.py или проверь вручную:

• Margin usage < 50%
• Дневной убыток < 2%
• Размер позиции разумный
• SL/TP установлены

Шаг 6. Решение и подтверждение

Сформулируй thesis:

• Направление + причина (TA + LSTM + новости)
• Вход, SL, TP, объём
• R:R ratio (минимум 2:1)
• Запроси подтверждение у пользователя

Workflow: Открытие позиции

1. Проверь risk limits (шаг 5 выше)
2. Определи брокерский тикер из instrument.json (см. references/ticker-formats.md)
3. Отправь ордер:

mcporter call my-n8n-mcp.Place_Order ticker=US500 side=buy type=market volume=0.1 price=0 stop_loss=6400 take_profit=6800

4. Залогируй сделку:

python3 scripts/trade_logger.py US500 buy 6600 0.1 "EMA crossover + LSTM bullish" --tags "indices,trend"

Workflow: Закрытие позиции

mcporter call my-n8n-mcp.Close_an_open_deal deal_id=12345

Или закрыть конкретный тикер — сначала получить список сделок:

mcporter call my-n8n-mcp.Deals

Ticker форматы

Контекст	Формат	Примеры
Брокерские ордера	Из instrument.json	US500, XAUUSD, EURUSD, TSLA, VXX
Аналитика/новости	Yahoo Finance	^GSPC, ^DJI, ^IXIC, GC=F, EURUSD=X, TSLA
LSTM даты	YYYY-MM-DD-HH-MM	2025-04-27-00-00

Подробнее: references/ticker-formats.md

Ключевые MCP эндпоинты

Аккаунт и торговля

Инструмент	Назначение
Get_account_data	Баланс, эквити, маржа
Deals	Текущие открытые сделки
Place_Order	Открыть позицию (⚠️ с подтверждения!)
Close_an_open_deal	Закрыть сделку по ID

Аналитика

Инструмент	Назначение
get_technical_analysis	RSI, MACD, Bollinger, EMA
predict_future_price_lstm	LSTM прогноз + VaR
get_options_data	Walls, gamma, PCR, max pain
get_company_fundamentals	Фундаментал компании
get_company_financial_scores	Скоринг 0-100

Новости

Инструмент	Назначение
CNBC_news	Новости CNBC
BBG_market	Bloomberg рынки
BEREZIN_sentiment	Сентимент Березина

Полный справочник: references/mcp-endpoints.md

Скрипты

Скрипт	Назначение
scripts/setup.sh	Первичная настройка (mcporter + .env)
scripts/market_analysis.py	Единый анализ актива (TA + LSTM)
scripts/risk_manager.py	Проверка risk limits перед ордером
scripts/trade_logger.py	Лог сделок в Qdrant

Первичная настройка

cd skills/qstrader
cp .env.example .env  # Заполнить свои ключи
bash scripts/setup.sh