Validar archivo de marketplace de plugins
Comprueba si un marketplace de plugins, cargado como un .zip del directorio del
marketplace, se sincronizaría en claude.ai, sin conectarlo ni almacenarlo.
Para comprobar en su lugar un repositorio público de GitHub, usa Validar repositorio de marketplace de plugins.
El informe indica si marketplace.json está bien formado, qué plugins omitiría una
sincronización y por qué, y qué plugins se sincronizarían solo en
parte, con algunos archivos excluidos. Un archivo que no se puede leer como marketplace se informa, no se rechaza: la respuesta es un informe con valid: false. Las fuentes de plugins fuera del marketplace
se obtienen de forma anónima desde GitHub, por lo que una privada se informa como no encontrada; una
fuente en cualquier otro host no se obtiene aquí, y el informe indica que se
comprobará cuando el marketplace se sincronice realmente.
No se registra nada en el feed de actividad de la Compliance API.
Para ver un ejemplo práctico, consulta Validar el contenido del marketplace en la guía de la API de Plugins.
Credenciales aceptadas: una clave de API de administrador con el alcance read:plugins o write:plugins; read:org_audit y read:compliance_org_data no lo otorgan.
Cada solicitud debe incluir el encabezado beta anthropic-beta: ce-plugins-2026-09-01. Una solicitud sin él devuelve 404, exactamente como si el endpoint no existiera. La API de Plugins está en beta y solo está disponible para organizaciones de Claude Enterprise. No está disponible para organizaciones de Claude Platform (Claude Console) ni para organizaciones con la preparación 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_archive(
archive=b"Example data",
)
)
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
}