O que naverstock-api-skill faz?
Skill do agente para API web somente leitura e não oficial do Naver Securities: stock.naver.com – consulta de dados de ações domésticas, ETFs, índices, notícias e pesquisas.
Visão Geral
Este skill permite que agentes de IA consultem dados financeiros da plataforma Naver Securities (stock.naver.com) por meio de uma API web não oficial. Ele foi projetado para extrair informações atualizadas sobre:
- Ações individuais (KOSPI, KOSDAQ)
- ETFs
- Índices de mercado (ex.: KOSPI 200, KOSDAQ)
- Notícias financeiras
- Relatórios de pesquisa (researches)
O skill é somente leitura e não requer autenticação. Basta especificar o parâmetro de consulta (como código da ação ou nome do índice) e o skill retorna os dados no formato JSON estruturado.
Plataformas Suportadas
- Claude Code
- Cursor
- Codex
- Outros agentes de IA compatíveis com skills
Como Usar
Exemplo de requisição para consultar dados de uma ação
// Exemplo de uso em um agente (sintaxe genérica)
skill: dd3ok/naverstock-api-skill type=stock code=005930
Parâmetros
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
type | string | Tipo de consulta: stock, etf, index, news, research | Sim |
code | string | Código numérico da ação/ETF/índice (ex.: 005930 para Samsung) | Sim (para stock, etf, index) |
limit | integer | Número máximo de resultados (padrão: 10) | Não |
query | string | Termo de busca (para news e research) | Sim (para news, research) |
Exemplos de uso
Consultar dados de uma ação
skill: dd3ok/naverstock-api-skill type=stock code=005930
Consultar notícias sobre IA
skill: dd3ok/naverstock-api-skill type=news query=인공지능 limit=5
Resposta
A resposta é um objeto JSON com os seguintes campos:
{
"success": true,
"data": {
"type": "stock",
"code": "005930",
"name": "Samsung Electronics",
"price": 74000,
"change": 1200,
"percent": 1.65,
"timestamp": "2023-11-20T14:30:00+09:00"
}
}
Para news e research, o campo data será uma lista de itens.
Limitações
- O skill depende da disponibilidade do site stock.naver.com. Se o site estiver inacessível, o skill não funcionará.
- Não há garantias sobre a precisão ou atualidade dos dados; use sob sua própria responsabilidade.
- O skill não oferece suporte a operações de escrita (compra/venda).
Licença
Este skill é fornecido apenas para fins educacionais e de integração. Consulte os termos de uso do Naver Securities antes de utilizar em produção.