Advisors AI Check

advisorsai-check

Uma página pública expõe o básico legível por máquina que os mecanismos de resposta podem usar?

Um comando. Sem chave de API, sem conta, sem cadastro.

Um clique dentro do seu agente (o GitHub remove links cursor:// — use os botões ao vivo): https://advisorsai.ai/see.html

npx skills add manmohm/advisorsai-check

/plugin marketplace add manmohm/advisorsai-check

Compartilhe uma página medida (padrão SSL Labs): https://advisorsai.ai/see.html?url=https://example.com

# one-off, nothing left behind (needs pipx: python -m pip install pipx)
pipx run --spec git+https://github.com/manmohm/advisorsai-check advisorsai-check example.com

# or install once
pipx install git+https://github.com/manmohm/advisorsai-check
advisorsai-check example.com

git clone https://github.com/manmohm/advisorsai-check.git
cd advisorsai-check
python -m pip install .
advisorsai-check example.com

Use no Claude ou em qualquer cliente MCP — sem instalação

A mesma verificação limitada de página pública está disponível como uma ferramenta MCP remota, somente leitura. Você fornece uma URL pública; ela retorna no máximo uma descoberta acionável com um recibo de evidência HMAC que o operador pode verificar novamente.

• Adicionar Advisors AI Store Readiness ao Claude
• Nome oficial no Registro MCP: ai.advisorsai/store-readiness
• Endpoint HTTP streamable: https://advisorsai.ai/store-readiness-mcp
• Inspecione a implementação do MCP e seu limite de operação

A ferramenta remota não grava no site enviado, não armazena o resultado, não o compartilha, não infere classificações de mecanismos de resposta nem prevê vendas. É nova: ainda não há estudos de caso de clientes.

advisorsai-check  https://example.com

  ok   page title: «Example — industrial valves since 1994»
  ok   meta description, 153 chars
  MISS no Organization/LocalBusiness structured data: nothing states what this
       business IS in a form machines read
  MISS no Service/Product structured data: what you sell is only in prose
  ok   one <h1>: «Valves that survive the plant floor»
  ok   canonical link with an HTTP(S) href is present
  ok   declared robots policy allows search crawlers on /
       (training/model-use crawlers blocked by policy: GPTBot, Google-Extended)
  note no /llms.txt (informational only: it is not a web standard)
  ok   valid urlset sitemap with 24 locations

  64% of the declared public-page basics checked in this run are in place.

Use como uma Skill de Agente

npx skills add manmohm/advisorsai-check

Agentes de codificação que seguem o formato Agent Skills podem carregar SKILL.md na raiz do repositório (tópico do GitHub ai-skill) ou skills/ai-site-readiness/SKILL.md: eles ensinam o agente a executar esta verificação, ler apenas evidências observadas e nunca reivindicar classificações.

Embuta o verificador ao vivo em outro README:

[![AI page readiness](https://advisorsai.ai/badge/ai-readiness.svg)](https://advisorsai.ai/see.html)

O que ele verifica

O que ele não verifica

Ele não informa se um assistente menciona você quando um comprador pergunta.

Isso não é estabelecido por uma busca de página. É uma observação de respostas ao vivo, e estabelecê-lo exige capturas com carimbo de data/hora contra assistentes reais e comparação com pares. Portanto, esta ferramenta nunca reclassifica suas verificações limitadas de página como uma pontuação de visibilidade.

Então, tudo aqui é um básico de página pública: uma condição técnica corrigível, não evidência de que um mecanismo de resposta vai citar você. Não é uma classificação. Não é uma participação. Não é uma promessa.

Instalar a partir do código-fonte

git clone https://github.com/manmohm/advisorsai-check.git
cd advisorsai-check
python -m pip install .
advisorsai-check example.com

O pacote ainda não foi publicado no PyPI. Não use nem divulgue um comando pip install advisorsai-check até que o lançamento exista lá. O núcleo do verificador de linha de comando suporta Python 3.9+. As dependências opcionais do servidor remoto exigem Python 3.10+, e o código-fonte do servidor publicado é para inspeção da implantação oficial do operador, e não uma promessa de auto-hospedagem pronta para uso. O pacote fixa html5lib==1.1 e webencodings==0.6.1 para que HTML malformado seja interpretado com um contrato estável de construção de árvore HTML5 e os rótulos de charset sigam o registro de codificação web WHATWG. O analisador HTML e o extrator de fatos rodam em um processo filho com limite de bytes e tempo; não há estimador de token ou aninhamento escrito à mão. Páginas iniciais devem ser servidas como text/html: application/xhtml+xml é deliberadamente rejeitado porque esta ferramenta não reivindica um contrato de análise XML. As respostas também devem ser uma representação de identidade não comprimida; valores de Content-Encoding não suportados são rejeitados em vez de serem analisados como bytes HTML.

Use no CI

GitHub Action (runner Ubuntu):

- uses: manmohm/advisorsai-check@main
  with:
    url: https://example.com
    min-score: "80"

--json dá a você o resultado completo. O código de saída 0 significa que todos os verificadores retornaram; 1 significa que pelo menos uma verificação estava indisponível ou falhou internamente; e 2 significa que o endereço enviado era inutilizável. Uma execução parcial publica score: null, relata coverage_percent ponderado, e nunca é um resultado de processo bem-sucedido:

set -o pipefail
advisorsai-check example.com --json | jq '.score'

- name: Public-page machine basics
  run: |
    git clone --depth 1 https://github.com/manmohm/advisorsai-check.git /tmp/advisorsai-check
    python -m pip install /tmp/advisorsai-check
    result=$(advisorsai-check "$SITE" --json) || {
      status=$?
      echo "$result"
      exit "$status"
    }
    score=$(printf '%s' "$result" | jq -er '.score')
    echo "Declared public-page basics: $score%"
    [ "$score" -ge 80 ] || { echo "::warning::below 80%"; }

Como biblioteca

from advisorsai_check import run

report = run("example.com")
if not report.successful:
    raise RuntimeError(report.errors)
print(report.score)
for signal in report.signals:
    if signal.ok is False:
        print("fix:", signal.detail)

report.successful é falso se qualquer sinal não foi verificado ou qualquer verificador levantou um erro interno. Nesse estado, report.score é None; use report.coverage_percent para descrever quanto do conjunto ponderado de verificações foi executado, nunca como uma pontuação substituta. O vocabulário do relatório é fechado: cada execução carrega exatamente um recibo para home, title, description, structured_business, structured_offering, h1, canonical, robots, llms_txt e sitemap, com pesos fixados pela biblioteca. jsonld_valid é o único diagnóstico opcional e pode ocorrer no máximo uma vez. Estágios ausentes, chaves desconhecidas, duplicatas, recibos vazios ou pesos alterados tornam o relatório malsucedido; eles nunca podem gerar uma pontuação ou cobertura de 100%. O recibo home também fixa as seis linhas derivadas da página: uma falha verificada na página inicial exige falhas verificadas para título, descrição, negócio estruturado, oferta estruturada, H1 e canônico; uma página inicial indisponível exige que todas as seis permaneçam indisponíveis. A linha opcional jsonld_valid é aceita apenas como um diagnóstico negativo (false) após uma representação completa da página inicial ter sido analisada. Ela pode diminuir uma pontuação, mas nunca pode atuar como um bônus positivo. Embora home e llms_txt sejam recibos de estágio com peso zero, deixar qualquer um sem verificação adiciona uma unidade de cobertura ausente, então uma execução parcial não pode exibir cobertura de 100%. signal.ok é True, False ou None. None significa que a verificação não pôde ser executada — uma falha de DNS, conexão, TLS ou tempo limite, por exemplo. Tais falhas são relatadas como não verificadas (ok: null), nunca como evidência de que o site falhou. Elas tornam toda a execução incompleta: report.successful é falso, report.score é None, e coverage_percent mostra apenas a parcela ponderada que realmente foi executada. O status 0 é reservado para esse estado de transporte/indisponibilidade. Uma resposta HTTP 4xx ou 5xx é diferente: o site respondeu, então produz um resultado verificado de acordo com o contrato desse sinal antes que o verificador considere o corpo da representação de erro ou Content-Type. Assim, um 4xx/5xx na página inicial é uma falha verificada mesmo quando o corpo está vazio ou mal rotulado; robots.txt mantém as semânticas distintas de 4xx/5xx da RFC 9309. Uma representação de página ou robots é completa apenas com HTTP 200 exato: status informativos/aceitos ou parciais/delta, como 202, 206 e 226, são rejeitados. Redirecionamentos para outra origem não são seguidos.

O primeiro site em que apontamos foi o nosso

Ele identificou uma incompatibilidade na política de rastreadores entre as regras de robots pretendidas do site e as regras servidas na borda. A lição é mais estreita do que uma reivindicação de classificação: inspecione o que os rastreadores públicos realmente recebem, não apenas o arquivo no repositório.

Nós não tínhamos notado. A ferramenta encontrou em uma única execução, o que é todo o argumento para executá-la no seu.

Quem fez isso

Advisors AI mede saídas de mecanismos de resposta com carimbo de data/hora para um negócio e constrói sistemas que o cliente então possui integralmente. Esta ferramenta é a parte gratuita e honesta: a parte que você pode verificar sozinho, offline, com o código-fonte diante de você.

A parte paga é a parte que esta ferramenta se recusa a adivinhar — o que os assistentes realmente dizem sobre você, com as capturas para provar, e o que mudar.

Licença MIT. Issues e pull requests são bem-vindos.