Download the PHP package tihhgoncalves/rocket-insta-api-php without Composer
On this page you can find all versions of the php package tihhgoncalves/rocket-insta-api-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tihhgoncalves/rocket-insta-api-php
More information about tihhgoncalves/rocket-insta-api-php
Files in tihhgoncalves/rocket-insta-api-php
Package rocket-insta-api-php
Short Description Projeto para automação de interações no Instagram
License MIT
Informations about the package rocket-insta-api-php
🚀 Rocket Insta API
Uma biblioteca em Node.js para integrar de forma simples com o Instagram usando Puppeteer, sessão persistente e execução sem interface gráfica.
📥 Instalação
Com Node.js 22 ou superior instalado, execute na pasta do projeto:
Copie .env.example para .env e configure suas credenciais localmente:
O arquivo .env, a sessão do navegador e as capturas locais ficam fora do Git.
📚 Principais Funcionalidades
- Login automático com reaproveitamento da sessão.
- Consulta de perfis e IDs pelo nome de usuário.
- Publicação de fotos no feed com legenda e marcações.
- Convites de colaboração em publicações.
- Publicação de stories com menções interativas.
- Execução headless, adequada para terminal e VPS.
- Verificação de publicações e diagnóstico sanitizado.
A versão 0.0.1 está em beta. A integração oferece biblioteca JavaScript e CLI; servidor HTTP, fila e agendamento ainda não estão implementados.
⚙️ Uso Básico
Pelo terminal
Antes de publicar, ajuste a conta, a imagem, a legenda e os usuários nos arquivos de exemplo. Cada execução envia no máximo uma imagem; sem --publish, os comandos de publicação exibem somente uma prévia local.
Como biblioteca
Arquivo de publicação
Para collab, informe os usuários em collaborators. Para stories, use mentions; colaboradores não são aceitos. Os caminhos de imagem são relativos ao arquivo JSON. Nesta beta, o formato aceito é JPEG de até 20 MB, enviado sem redimensionamento.
🖥️ Terminal e VPS
Importar uma sessão por cookies
Como alternativa ao envio de senha, importe os cookies de uma sessão já autenticada. Execute npm run import-cookies -- --account seu_usuario e cole, no prompt oculto, um JSON em uma única linha com este formato:
Os valores reais não devem ser digitados no comando do shell, em opções da CLI nem em arquivos versionados. A leitura também aceita um JSON fornecido por stdin até EOF, para integração com uma fonte segura; não é necessário criar arquivo intermediário. A entrada é limitada a 32 KiB.
Na biblioteca, use await insta.importCookies(cookies, { account: 'seu_usuario' }) depois de open(). O método aceita o objeto acima ou uma lista restrita de objetos name/value com atributos de cookie. Rejeita nomes extras, duplicados, valores inválidos, domínios externos, URLs não oficiais, caminhos diferentes de / e atributos inseguros.
Os três cookies são instalados para .instagram.com, raiz /, com secure: true; sessionid é HttpOnly. Sem expiração fornecida, a persistência local é limitada a sete dias. Isso não prolonga a validade da sessão no servidor. Uma expiração explícita válida é preservada; expires: -1 indica cookie de sessão.
A importação abre a página inicial apenas para leitura e confere username e ID. Não publica nem submete senha. Se a conta divergir, a sessão não for confirmada ou houver falha, tenta restaurar os três cookies anteriores. Valores de cookies nunca são retornados, impressos ou gravados em relatórios; o perfil persistente do Chrome armazena a sessão e deve permanecer protegido.
Depois de confirmada a importação, login() reutiliza a sessão válida antes de considerar qualquer senha. Cookies expirados ou recusados ainda podem exigir reautenticação ou verificação do Instagram. Esta funcionalidade tem testes sem rede e validação de atributos em navegador com cookies sintéticos; a importação real no PRD deve ser validada separadamente.
O navegador funciona em modo headless por padrão. Configure IG_PROFILE_DIR para usar um diretório persistente de sessão e execute um processo por perfil de navegador.
No Linux, instale as bibliotecas de sistema exigidas pelo Chrome e execute com usuário próprio, preservando o sandbox. Consulte o guia oficial do Puppeteer para os requisitos da distribuição. Faça o primeiro login no próprio VPS.
Se o Instagram apresentar um formulário de código compatível, a CLI solicita o código no terminal interativo. Na biblioteca, use o callback requestCode. CAPTCHA e outros desafios visuais interrompem o fluxo com diagnóstico; não são resolvidos automaticamente.
O login aguarda o botão de envio aparecer e ficar habilitado após preencher os campos, por até 15 segundos. Se o formulário continuar indisponível ou houver botões ambíguos, retorna FORM_CHANGED sem clicar. Um clique que falhar não é repetido automaticamente.
Após o envio, os eventos login_state e login_response informam somente categorias conhecidas. Em caso de timeout, login_diagnostic e error.diagnostics incluem indicadores como código pendente, aprovação em outro dispositivo, resposta recusada ou cookies presentes sem sessão confirmada. Na biblioteca, getLastLoginDiagnostics() também retorna esse diagnóstico, quando disponível.
O relatório JSON e a imagem sanitizada são gravados em rocket-diagnostics/, dentro do diretório do perfil, quando houver permissão de escrita. A imagem mostra um painel local com os indicadores permitidos; não fotografa a página original. Não inclui conteúdo da tela, campos preenchidos, mensagens remotas, URLs completas nem valores de cookies. Se o relatório não puder ser gravado, o erro original é preservado. Não há reenvio da senha para gerar o diagnóstico.
Para desenvolvimento local com janela visível:
As publicações não são repetidas automaticamente. Se uma operação ficar sem confirmação, confira o perfil antes de executar novamente. Convites de colaboração dependem da aceitação do destinatário; menções em stories criam uma área clicável, sem desenhar texto na imagem.
🧪 Testes e Diagnóstico
Os testes automatizados usam dados fictícios e não publicam conteúdo. O teste de navegador usa HTML sintético. O comando inspect acessa a sessão e mostra somente nomes e atributos dos cookies, método, caminho e status das chamadas observadas.
Capturas ficam em .local/screenshots/, ignoradas pelo Git. Senhas, tokens, valores de cookies e corpos das requisições não são impressos nos diagnósticos. Proteja .env e .local/ com permissões restritas no servidor.
Login automático, busca de IDs, feed com marcação, convite de collab e story com menção foram validados localmente em modo headless. A validação em VPS Linux e a autenticação real com código de verificação continuam pendentes.
🙌 Contribuições
Contribuições são bem-vindas! Abra uma issue para relatar problemas ou sugerir melhorias.
Consulte o convenções do projeto para desenvolvimento, testes e cuidados com a sessão.
👨💻 Mantenedor
Este projeto é mantido por Tihh Gonçalves.
🔗 Redes e Contato
🚀 Rocket Produtora Digital
Criado com ♥ pela Rocket Produtora Digital
📄 Licença
Distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.