aifeed.md

Protocolo AIFeed para la sección de herramientas de construcción. AIFeed permite a los editores web proporcionar fuentes de contenido verificadas y eficientes en tokens para agentes de IA.

GitHub

Documentación

AIFeed

English · Bahasa Indonesia · 中文

Permisos de contenido firmados para la web de IA.
Declara, firma y revoca lo que los agentes de IA pueden hacer con tu contenido — y permite que los agentes lo demuestren.

Sitio web · Flujo del protocolo · Benchmark · Guía completa · Artículo (PDF)

Inicio rápido en 1 minuto

Lado del editor — firma lo que los agentes pueden hacer con tu contenido:

npx aifeed keygen --out .aifeed                         # Ed25519 key pair
npx aifeed site build ./public --domain example.com \
  --key .aifeed/aifeed-private.pem --llms --inject      # manifest + page markdown + index
npx aifeed validate ./public --domain example.com       # verify locally

¿Prefieres cero configuración? npx aifeed init --domain example.com --dir ./site crea las claves, un manifiesto firmado y la guía de configuración de DNS/host en un solo paso.

Lado del agente — verifica cualquier dominio en 3 líneas:

npm install @aifeed/verify

const { verifyRemote } = require('@aifeed/verify');
const out = await verifyRemote('example.com'); // discovery → signature → DNS anchor
console.log(out.result, out.anchor.status);    // VERIFIED anchored

TypeScript: import { verifyRemote } from '@aifeed/verify';

A dónde ir después: ¿Por qué AIFeed? · inicio rápido para agentes · guía de IA para editores · npm: aifeed CLI · @aifeed/verify

¿Por qué AIFeed?

Los agentes de IA ahora generan una parte grande y creciente del tráfico web, pero las señales que indican lo que pueden hacer son archivos de texto sin firmar. Cualquiera puede editarlos, nada los vincula a un dominio, y no hay forma de revocarlos. La asimetría es medible:

1.9 mil millones de rastreos ignoraron las reglas de robots.txt en un solo semestre (un proveedor).
Se midió una proporción de 70,900 : 1 de rastreos a referencias para un proveedor importante de IA.
Los bots de IA promediaron 4.2 % de las solicitudes HTML en 2025, alcanzando un máximo de 6.4 %.

AIFeed reemplaza "por favor respeta este archivo" con una declaración criptográficamente verificable, más contenido ágil listo para agentes que reduce costos en ambos lados.

Cómo funciona

Genera un par de claves Ed25519 — la clave privada nunca sale del origen.
Publica un manifiesto firmado en /.well-known/ai.json: permisos por uso (entrenamiento, recuperación, cita, …), límites de rastreo, licencia, revisión.
Ancla la clave en DNS (_aifeed TXT) para que un manifiesto no pueda ser suplantado por otro dominio.
Los agentes verifican la cadena — TLS → dominio → firma (JCS + Ed25519) → ancla DNS — y vuelven a verificar un registro de revocación con múltiples firmas en cada uso.
Rota las claves de forma segura — anuncia el sucesor con una directiva firmada con la clave anterior (más una verificación cruzada de DNS pk2 como aviso), mantén una superposición limitada, cambia, luego revoca la clave anterior permanentemente. Runbook: docs/rotation.md.
Sirve contenido ágil bajo uno de dos perfiles (abajo), con un índice delta firmado para que las páginas sin cambios cuesten 0 bytes.

Para agentes de IA: la guía de verificación primero (descubrimiento → verificación → decisiones de permisos → delta → manejo de fallos) está en docs/agent-quickstart.md, con un ejemplo ejecutable en examples/agent/compliant-agent.js.

Verifica desde otras pilas

Paquete Python independiente (solo biblioteca estándar):

pip install aifeed

from aifeed import verify

report = verify.verify_directory('./my-site', domain='example.com')
print(report['result'], report['errors'])

¿Prefieres el repositorio? El mismo CLI está aquí (cero dependencias, Node ≥ 20):

cd aifeed-protocol
node bin/cli.js keygen --out keys/
node bin/cli.js validate https://example.com
node bin/cli.js site build ./public --domain example.com --key keys/aifeed-private.pem

Dos perfiles de contenido

Perfil	Tipo de medio	Extensión	Notas
AIFeed Markdown (nativo)	`text/aifeed+markdown`	`.aifeed.md`	Bloque de política firmado en banda, presupuesto de tokens, traducción `alternates`, metadatos de triaje
MAKO (compatibilidad)	`text/mako+markdown`	`.mako.md`	Perfil de confianza MAKO externo, servido desde los mismos bytes firmados con su propio contexto de firma

Los orígenes de doble pila sirven ambos; la reproducción entre formatos se rechaza por diseño.

Resultados medidos

Todos los números son reproducibles a partir de artefactos confirmados (npm run bench:mako, npm run bench:enforcement); el entorno de prueba es una sola máquina en red de bucle local con un corpus sintético de 60 páginas. Se incluye una línea base honesta.

Qué	Resultado	Etiqueta
Conversión a perfiles markdown vs HTML	−68.83 % bytes transferidos	medido
Consumo delta (10 % de páginas cambiadas)	−95.73 % vs rastreo HTML	medido
Bytes de salida del editor / CPU / conexiones máximas	−55.19 % / −56.23 % / −88.24 %	medido (simulación)
Bytes recibidos del lado de IA (todos los perfiles / cliente conforme)	−54.84 % / −72.93 %	medido (simulación)
Páginas sin cambios omitidas	14 de 18	medido (simulación)
Costo de verificación de firma	0.70 ms / página	medido

El piloto en vivo de 30 días aún no se ha ejecutado; las proyecciones por 1,000 inquilinos están etiquetadas como extrapolaciones de modelo, y las afirmaciones de proveedores de hasta 94 % de reducción de tokens requieren resumen semántico que este proyecto no realiza automáticamente.

Qué hay en este repositorio

Ruta	Contenido
`lib/` + `bin/`	Implementación de referencia sin dependencias y CLI
`packages/` + `clients/python/`	Paquetes publicados: CLI (`aifeed`), SDK (`@aifeed/verify`), servidor MCP, complementos de compilación (`@aifeed/frameworks`), verificador PyPI `aifeed`
`conformance/`	Vectores de conformidad: 34 manifiesto · 39 MAKO · 11 AIFeed Markdown
`wp-plugin/`	Complemento de WordPress: manifiesto firmado, doble pila AIFeed Markdown + MAKO, `/llms.txt`
`spec/`	Especificaciones EN/ID: manifiesto v0.1/v0.2, AIFeed Markdown v1.0
`schema/`	Esquemas JSON para manifiestos, firmas, AIFeed Markdown, MAKO
`paper/`	Preimpresión: fuente LaTeX, PDF, registro de afirmaciones, paquete arXiv
`docs/`	Inicio rápido para agentes, guías de implementación y espacios de nombres, notas del proyecto en indonesio
`REFERENCE.md`	Detalles de la implementación de referencia, qué se verifica, inicio rápido del CLI

Documentación

Especificaciones: spec/en · spec/id · esquemas
Implementación de referencia: REFERENCE.md
Contrato de mantenimiento (agentes de IA y desarrolladores): AGENTS.md
Arquitectura: docs/architecture.md · Guía de lanzamiento: docs/release.md
Inicio rápido para agentes (lado del cliente): docs/agent-quickstart.md
Guía de IA para editores (lado del propietario): docs/publisher-ai-guide.md
Publisher Studio (aplicación local): studio/README.md
Guía completa: penjelasan-aifeed.html (fuente de https://aifeed.md/penjelasan.html)
Política de seguridad: SECURITY.md
Política de gobernanza y código abierto: GOVERNANCE.md
Implementación del sitio: docs/deploy-site.md
Notas de envío a arXiv: paper/ARXIV-SUBMISSION.md

Estado

Lanzamiento 1.0.0-draft — las especificaciones no están congeladas todavía. Versiones de cable: manifiesto 0.1/0.2, AIFeed Markdown 1.0, MAKO 0.2.
Conformidad: 34 vectores de manifiesto + 39 MAKO + 11 AIFeed Markdown, ejecutados por verificadores independientes de JavaScript y Python, más fixtures diferenciales de PHP, más de 90,000 ejecuciones de fuzzing y una prueba de extremo a extremo de WordPress.
No reclamado: revisión criptográfica externa y un piloto en vivo (ambos pendientes); el compromiso de origen+DNS es indetectable en el primer contacto.

Licencia y contacto

Especificaciones CC BY 4.0 · código de referencia y complemento MIT · vectores CC0. Contacto: contact@aifeed.md — informes de seguridad según SECURITY.md.