# XOOMAR market data

Отдаёт агенту 26 инструментов с рыночными данными США: отчёты SEC, инсайдеры, короткие позиции, 13F, COT и ликвидность ФРС. Ключ не нужен, чтобы начать.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Автор: xoomar-code
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/xoomar-code/xoomar-mcp
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/mcp/xoomar-market-data

## Что делает

Сервер подключается двумя способами. Хостинг по адресу `https://xoomar.com/mcp` работает по Streamable HTTP, локально тот же набор инструментов поднимается через `npx -y xoomar-mcp` по stdio. Внутри 26 инструментов поверх 31 набора данных, собранных из первоисточников: SEC EDGAR и XBRL, FINRA, CFTC, Федеральная резервная система, USAspending и биржевые API.

Без ключа лимит 10 запросов в минуту на IP, с бесплатным ключом аккаунта — 30. В обоих случаях история отдаётся не глубже шести месяцев. Переменная `XOOMAR_MAX_ROWS` задаёт число строк в ответе инструмента, по умолчанию 200. Каждый результат несёт `updatedAt`, `source` и строку `sourceAttribution` — её нужно показывать при публикации данных, вместе со ссылкой на страницу набора на xoomar.com.

Лицензия Apache-2.0 покрывает код, но не сами данные: что с ними можно делать, описано в условиях на xoomar.com. Если планируете перепубликацию, это стоит прочитать до того, как строить на них отчёт.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://xoomar.com/mcp`
- Переменные окружения: `XOOMAR_API_KEY`, `XOOMAR_MAX_ROWS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http xoomar-mcp https://xoomar.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env XOOMAR_API_KEY=<XOOMAR_API_KEY> --env XOOMAR_MAX_ROWS=<XOOMAR_MAX_ROWS> --transport stdio xoomar-market-data -- npx -y xoomar-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add xoomar-market-data --url https://xoomar.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add xoomar-market-data --env XOOMAR_API_KEY=<XOOMAR_API_KEY> --env XOOMAR_MAX_ROWS=<XOOMAR_MAX_ROWS> -- npx -y xoomar-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xoomar-market-data": {
            "url": "https://xoomar.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xoomar-market-data": {
            "command": "npx",
            "args": [
                "-y",
                "xoomar-mcp"
            ],
            "env": {
                "XOOMAR_API_KEY": "<XOOMAR_API_KEY>",
                "XOOMAR_MAX_ROWS": "<XOOMAR_MAX_ROWS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "xoomar-market-data": {
            "type": "http",
            "url": "https://xoomar.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "xoomar-market-data": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "xoomar-mcp"
            ],
            "env": {
                "XOOMAR_API_KEY": "<XOOMAR_API_KEY>",
                "XOOMAR_MAX_ROWS": "<XOOMAR_MAX_ROWS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http xoomar-market-data https://xoomar.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e XOOMAR_API_KEY=<XOOMAR_API_KEY> -e XOOMAR_MAX_ROWS=<XOOMAR_MAX_ROWS> xoomar-market-data npx -y xoomar-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- посмотреть короткие позиции по тикеру с днями на покрытие
- найти компании, где несколько инсайдеров покупали на открытом рынке
- выяснить, какие управляющие из 13F держат бумагу
- собрать квартальные и годовые показатели из XBRL
- проверить чистую ликвидность ФРС и её составляющие

## Примеры запросов агенту
- Как менялись короткие позиции по GME в этом году?
- Покажи покупки инсайдеров на открытом рынке за последние 7 дней
- Что сейчас происходит с чистой ликвидностью ФРС?

## Похожие
- [market-data](https://affpapa.org/nevibecode/skills/rebyteai-template-market-data.md) — скилл · 380 установок
- [TickDB Market Data](https://affpapa.org/nevibecode/mcp/tickdb-market-data.md) — MCP-сервер · ★ 893
- [FactIQ](https://affpapa.org/nevibecode/mcp/factiq.md) — MCP-сервер · ★ 19
- [longbridge-market-data](https://affpapa.org/nevibecode/skills/longbridge-market-data.md) — скилл · 3300 установок
- [llmquant-data](https://affpapa.org/nevibecode/skills/llmquant-data.md) — скилл · 511 установок
- [0xArchive Market Data](https://affpapa.org/nevibecode/mcp/0xarchive-market-data.md) — MCP-сервер · ★ 13

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
