liuboacean/zhihu-automation-skill

O que zhihu-automation-skill faz?

Skill de automação do Zhihu — publicar artigos/ideias/perguntas e respostas/interação/extração de dados, arquitetura de canal duplo. Ferramenta de automação para Zhihu com canal duplo (leitura HTTP + escrita via navegador).

Visão Geral

Este skill permite que agentes de IA interajam com a plataforma Zhihu de forma programática. Ele combina requisições HTTP para operações de leitura (coleta de dados, crawler) e automação de navegador usando Playwright para operações de escrita que exigem interação com a interface do usuário (login, publicação, curtidas, etc.).

Principais Funcionalidades

• Publicação de Artigos: Crie e publique artigos completos no Zhihu.
• Publicação de Ideias: Publique ideias curtas (semelhantes a posts ou tweets).
• Perguntas e Respostas: Faça perguntas ou publique respostas em perguntas existentes.
• Interações: Curta, colete (bookmark) ou siga usuários e tópicos.
• Extração de Dados: Extraia informações de perfis, perguntas, artigos e listas.
• Interface de Canal Duplo: Use HTTP para operações rápidas de leitura; use navegador para operações que exigem autenticação e interação com UI.

Compatibilidade

• Claude Code: Totalmente suportado.
• Cursor: Suportado.
• Codex: Suportado.
• Outros Agentes: Qualquer agente que suporte execução de ferramentas em Node.js/TypeScript pode se beneficiar deste skill.

Autenticação

O skill requer autenticação na plataforma Zhihu. As credenciais (cookies, tokens de acesso) podem ser fornecidas via variáveis de ambiente ou arquivo de configuração.

Configuração

1. Instalar dependências:

npm install

2. Configurar variáveis de ambiente: Crie um arquivo .env (nunca commitar) com:

ZHIHU_COOKIES=<cookies de autenticação do Zhihu>
ZHIHU_ACCESS_TOKEN=<token de acesso, se aplicável>

3. Configurar caminhos do navegador (opcional): Se o Playwright não encontrar o navegador automaticamente, defina:

PLAYWRIGHT_BROWSERS_PATH=<caminho para binários do navegador>

Uso

Exemplo: Publicar um artigo

import { zhihuSkill } from './skill';

const resultado = await zhihuSkill.publishArticle({
  title: 'Título do Artigo',
  content: 'Conteúdo do artigo em Markdown...',
  category: 'Tecnologia',
  tags: ['IA', 'Automação']
});

Exemplo: Coletar dados de um perfil

const perfil = await zhihuSkill.scrapeProfile({
  username: 'exemplo_usuario'
});

Exemplo: Interagir (curtir) uma resposta

await zhihuSkill.likeAnswer({
  answerId: '12345678'
});

Estrutura de Ferramentas

Ferramenta	Descrição	Canal
publishArticle	Publica um artigo completo no Zhihu	Navegador
publishIdea	Publica uma ideia curta	Navegador
askQuestion	Faz uma nova pergunta	Navegador
answerQuestion	Publica uma resposta para uma pergunta	Navegador
likeContent	Curte um artigo, resposta ou ideia	Navegador
scrapeArticles	Extrai artigos de um perfil ou tópico	HTTP
scrapeQuestions	Extrai perguntas de um tópico ou feed	HTTP
getUserInfo	Obtém informações básicas do perfil	HTTP

Fluxo de Trabalho Recomendado

1. Autentique: Execute a ferramenta de login (se disponível) ou configure cookies manualmente.
2. Monitore: Use ferramentas de scraping para monitorar tópicos ou perfis.
3. Interaja: Baseado nos dados coletados, publique, curta, responda.
4. Mantenha: Use a automação de navegador para tarefas que precisam de sessão ativa.

Notas de Segurança

• Nunca compartilhe suas credenciais do Zhihu.
• Respeite os termos de serviço do Zhihu quanto à automação.
• Use tax limiting para evitar bloqueios.
• Armazene cookies e tokens com segurança (use variáveis de ambiente).

Suporte

Para dúvidas ou relatórios de bugs, abra uma issue no repositório GitHub: https://github.com/liuboacean/zhihu-automation-skill

---

Este skill foi projetado para desenvolvedores e agentes de IA que precisam integrar funcionalidades do Zhihu em seus fluxos de trabalho automatizados.