convez.ai
MCP ServerFinanceiroAvançado
kevinkda

Stock Research Skill

kevinkda/stock-research-skill

Orquestração multi-MCP para pesquisa de equities com shakeouts, earnings e insider trades

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que orquestra três ferramentas de pesquisa de ações (Schwab, SEC-EDGAR, Polygon) em playbooks integrados de análise fundamentalista. Permite executar cenários como detecção de quedas de preço com análise de notícias e rastreamento de transações de insiders em um único fluxo de trabalho.

Instalação

$npx convez-ai kevinkda/stock-research-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 4 meses
Versão
v0.4.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Análise integrada de quedas de preço combinada com sentimento de notícias
  • Rastreamento automatizado de transações de insiders com contexto de mercado
  • Filtros cruzados de watchlist por sinais técnicos e eventos corporativos
  • Automação de workflows de investimento com dados de múltiplas fontes

Veredito

Skill bem arquitetado para quem precisa orquestrar múltiplos MCPs em fluxos financeiros complexos. Requer familiarity com MCP servers e setup local, mas oferece integração sólida entre dados de mercado, regulatórios e de notícias.

README

A tradução para o português deste README ainda está na fila.

stock-research-skill

English | 简体中文

License Translation Skills Release Releases

A Cursor / Claude Code skill pack that orchestrates three MCP servers — schwab-marketdata-mcp, sec-edgar-mcp, and polygon-news-mcp — into multi-step equity-research playbooks for the kevinkda/stock-personal investment workflow.

This skill is read-only documentation; the actual API traffic is owned by the three MCP servers above.


Overview

This repository ships one cross-MCP skill in two language variants (简体中文 primary + English mirror), so an agent can be steered to whichever prose language fits the user's request:

  • stock-research (Chinese primary) — multi-step playbooks that join shakeout signals (schwab) with news sentiment (polygon) and insider filings (sec-edgar).
  • stock-research-en (English mirror) — same scope, English prose.

Both skills:

  • Share the same activation handshake (3 × health_check + git/gh private-repo gate).
  • Share the same governance rules (private-repo-only writes; never push to main; no force-push; per-MCP version range gating).
  • Differ only in prose language and the language_directive frontmatter field.

Skill variants

SkillLanguageWhen to use
stock-research简体中文 (primary)Cross-MCP equity research playbooks (shakeout-with-news, insider-alert).
stock-research-enEnglish (mirror)Same scope as stock-research, English prose.

Use stock-research for "shakeout 配新闻", "扫 watchlist 内部人", "shakeout-with-news", "insider-alert". If the user only needs a single MCP server, prefer the per-server skill packs (schwab-marketdata-skill, future sec-edgar-skill / polygon-news-skill).


Compatibility with the MCP servers

This skill repoCompatible MCP servers
v0.1.xschwab-marketdata-mcp >=0.3,<0.4 + sec-edgar-mcp >=0.2,<0.3 + polygon-news-mcp >=0.2,<0.3

The version ranges are encoded in each SKILL.md's mcp_dependencies frontmatter. The activation handshake calls health_check() on every server and refuses to continue if any server_version falls outside its range.


Installation

The exact mechanism depends on your client version. Typical layouts:

Cursor

Cursor discovers user-level skills under ~/.cursor/skills/ plus any directory the user adds via Settings → Skills. Symlink (or copy) the folders you want — install the Chinese primary, the English mirror, or both:

# Chinese primary (default for this repo)
ln -s "$(pwd)/stock-research"     ~/.cursor/skills/stock-research

# English mirror (optional; install in addition or instead)
ln -s "$(pwd)/stock-research-en"  ~/.cursor/skills/stock-research-en

Claude Code

Claude Code picks up ~/.claude/skills/<name>/SKILL.md. The same symlink approach works:

ln -s "$(pwd)/stock-research"     ~/.claude/skills/stock-research
ln -s "$(pwd)/stock-research-en"  ~/.claude/skills/stock-research-en

Prerequisite: all three companion MCP servers must already be registered. See each server's docs/REGISTER.md:

See also docs/REGISTER.md in this repo for the combined activation checklist.


License

MIT License — see LICENSE.


Acknowledgements

This skill pack is the cross-MCP companion to:

  • schwab-marketdata-mcp — read-only Schwab Market Data MCP server (12 tools, OAuth, DuckDB cache).
  • sec-edgar-mcp — read-only SEC EDGAR MCP server (filings, Form 4 / Form 13F XBRL).
  • polygon-news-mcp — read-only Polygon news MCP server (ticker news, sentiment aggregate).

The skill markdown design pattern is inspired by the schwab-marketdata-skill companion repo and Anthropic's published skill packs.

This project is not affiliated with, endorsed by, or sponsored by Charles Schwab Corporation, the U.S. Securities and Exchange Commission, or Polygon.io. Each MCP server independently complies with its upstream provider's Terms of Service. Schwab Market Data is non-redistributable; all derived markdown stays in the private kevinkda/stock-personal repo.


See also

  • stock-personal — private investment journal target repo (this skill writes to its research/ directory only).
  • schwab-marketdata-skill — single-MCP playbooks (shakeout-analysis-v2, voo-qqq-tracker, watchlist-snapshot, summary-md-refresh, option-chain-research).
Ver o original no GitHub

Bom para

Relacionados