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.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

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.

Último Commit Node.js Contribuidores do GitHub


📥 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

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

GitHub Telegram


🚀 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.


All versions of rocket-insta-api-php with dependencies

PHP Build Version
Package Version
Requires php Version ^7.4 || ^8.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tihhgoncalves/rocket-insta-api-php contains the following files

Loading the files please wait ...