Validar repositório do marketplace de plugins
Verifique se um marketplace de plugins mantido em um repositório público do GitHub seria sincronizado no claude.ai, sem conectá-lo nem armazená-lo.
Para verificar um .zip do diretório do marketplace, use Validar arquivo do marketplace de plugins.
O relatório informa se o marketplace.json está bem formado, quais plugins uma sincronização ignoraria e por quê, e quais plugins seriam sincronizados apenas em parte, com alguns arquivos deixados de fora. Um repositório ausente, privado ou sem o branch ou commit indicado é relatado, não recusado: a resposta é um relatório com valid: false. As fontes de plugins fora do marketplace são buscadas anonimamente no GitHub, então uma fonte privada é relatada como não encontrada; uma fonte em qualquer outro host não é buscada aqui, e o relatório indica que ela será verificada quando o marketplace for efetivamente sincronizado.
Nada é registrado no feed de atividades da Compliance API.
Para um exemplo prático, consulte Validar o conteúdo do marketplace no guia da API de Plugins.
Credenciais aceitas: uma chave de API de Admin com o escopo read:plugins ou write:plugins; read:org_audit e read:compliance_org_data não concedem acesso.
Toda solicitação deve incluir o cabeçalho beta anthropic-beta: ce-plugins-2026-09-01. Uma solicitação sem ele retorna 404, exatamente como se o endpoint não existisse. A API de Plugins está em beta e está disponível apenas para organizações Claude Enterprise. Ela não está disponível para organizações da Claude Platform (Claude Console) nem para organizações com prontidão para HIPAA habilitada.
Parameters
Returns
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get(
"ANTHROPIC_API_KEY"
), # This is the default and can be omitted
)
beta_plugin_marketplace_validation_report = (
client.beta.organization.plugin_marketplaces.validate_repository(
repository_url="https://github.com/example-org/example-marketplace",
)
)
print(beta_plugin_marketplace_validation_report.valid){
"commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
"manifest_error": "manifest_error",
"manifest_error_code": "marketplace_sync_manifest_not_found",
"plugin_errors": [
{
"error": "error",
"error_code": "marketplace_sync_plugin_missing_manifest",
"name": "name"
}
],
"plugin_warnings": [
{
"name": "name",
"warnings": [
{
"error_code": "marketplace_sync_zipball_symlink_dangling",
"message": "message"
}
]
}
],
"ref": "main",
"total_plugin_count": 0,
"type": "plugin_marketplace_validation_report",
"valid": false
}Returns Examples
{
"commit_sha": "9fceb02d0ae598e95dc970b74767f19372d61af8",
"manifest_error": "manifest_error",
"manifest_error_code": "marketplace_sync_manifest_not_found",
"plugin_errors": [
{
"error": "error",
"error_code": "marketplace_sync_plugin_missing_manifest",
"name": "name"
}
],
"plugin_warnings": [
{
"name": "name",
"warnings": [
{
"error_code": "marketplace_sync_zipball_symlink_dangling",
"message": "message"
}
]
}
],
"ref": "main",
"total_plugin_count": 0,
"type": "plugin_marketplace_validation_report",
"valid": false
}