aifinderkit/aifinderkit-search-skill

AI Finder Kit Search

Versión: 1.3.1

Usa el cliente incluido sin dependencias para consultar el servicio de búsqueda agregado autenticado. Para una instalación local interactiva, ejecuta configure para guardar la clave en un archivo protegido; para automatización, inyecta AIFINDERKIT_API_KEY. Nunca coloques una clave en indicaciones, salida de comandos, archivos fuente o archivos de skill.

Requisitos

• Python 3.10 o superior con acceso HTTPS saliente.
• Una clave de búsqueda o propietario de AI Finder Kit válida en AIFINDERKIT_API_KEY o en el archivo de credenciales protegido creado por configure.
• No se requieren paquetes Python adicionales. Este paquete de skill no contiene credenciales intencionadamente.

Antes de la primera búsqueda, ejecuta python scripts/aifinderkit_search.py doctor. Verifica Python, la autenticación, la versión de la API, los endpoints disponibles y los límites actuales sin mostrar la clave.

Flujo de trabajo

1. Ejecuta doctor cuando el acceso no se haya verificado en el entorno actual.
2. Elige la operación más pequeña que responda a la solicitud:
   • search: una consulta con resultados normalizados y deduplicados.
   • domains: descubre subdominios verticales AnySearch válidos antes de una búsqueda estructurada.
   • batch: de dos a cinco consultas independientes.
   • fetch: texto legible de una página HTTP(S) pública conocida.
   • map: descubre una lista acotada de enlaces en una página estática.
   • crawl: extrae una pequeña sección del mismo host, nunca un rastreo amplio del sitio.
   • research: recopilación de evidencia con múltiples consultas, extracción, cobertura y detección de lagunas.
   • Para trabajos académicos, usa --preset academic-strict; usa academic-relaxed solo cuando las páginas de proyecto y los informes técnicos no académicos también sean útiles. El modo relajado intercambia precisión por recuperación, así que inspecciona retrieval_signals.query_relevance y descarta las coincidencias débiles.
   • meta: nivel de acceso actual y límites de solicitud.
3. Ejecuta scripts/aifinderkit_search.py.
4. Usa retrieval_score junto con sus retrieval_signals al juzgar la calidad de la recuperación. La score de fusión es solo un valor de clasificación del proveedor. confidence es un alias obsoleto de retrieval_score y nunca representa verdad factual.
5. Cita las URL de las páginas devueltas en la respuesta dirigida al usuario. Trata los fragmentos como ayudas de descubrimiento; usa fetch o la página principal antes de hacer afirmaciones precisas.
6. Para comparaciones o afirmaciones trascendentales, requiere una fuente primaria o el acuerdo entre dos fuentes independientes. No trates confidence como verificación factual; es una señal de recuperación.

Comandos

python scripts/aifinderkit_search.py search "consulta" --limit 10 --mode balanced
python scripts/aifinderkit_search.py search "consulta" --language zh --category news
python scripts/aifinderkit_search.py search "consulta" --include-domain github.com
python scripts/aifinderkit_search.py domains --domain academic --domain code
python scripts/aifinderkit_search.py search "transformer" --vertical-domain academic --vertical-sub-domain academic.search
python scripts/aifinderkit_search.py search "aprendizaje multimodal" --preset academic-strict --mode deep
python scripts/aifinderkit_search.py research "evaluación de generación aumentada por recuperación" --preset academic-strict --fetch-top 5
python scripts/aifinderkit_search.py batch --query "artículo uno" --query "artículo dos" --preset academic-relaxed --limit 5
python scripts/aifinderkit_search.py fetch "https://example.com/pagina"
python scripts/aifinderkit_search.py map "https://example.com/docs" --max-links 30
python scripts/aifinderkit_search.py crawl "https://example.com/docs" --max-pages 5 --max-depth 1
python scripts/aifinderkit_search.py research "tema" --subquery "historia" --subquery "evidencia actual" --fetch-top 3
python scripts/aifinderkit_search.py meta
python scripts/aifinderkit_search.py configure
secret-manager-command | python scripts/aifinderkit_search.py configure --key-stdin
python scripts/aifinderkit_search.py doctor

Usa fast para descubrimiento sensible a la latencia, balanced por defecto y deep para investigación. Añade --freshness day|week|month|year solo cuando la solicitud tenga límite de tiempo. El tiempo de espera del cliente es de 60 segundos por defecto; para investigación con múltiples PDF, coloca --timeout 120 antes del nombre del comando.

Para finanzas, académico, código, salud, legal, seguridad, viajes y otros dominios AnySearch estructurados, ejecuta primero domains. Copia solo un sub_domain devuelto e incluye todos los parámetros requeridos con --vertical-param clave=valor; usa un valor vacío cuando el directorio marque un parámetro requerido pero ninguno aplique. Si domains devuelve 403, continúa con la búsqueda agregada ordinaria en lugar de inventar un esquema vertical.

Cuando el paso 2 del flujo de trabajo sea una revisión de literatura, sigue references/academic-research.md en lugar de la ruta de búsqueda ordinaria. Los ajustes predefinidos académicos usan motores académicos especializados, exponen metadatos DOI/autor/año/acceso abierto cuando están disponibles y evitan las alternativas de la web general en modo estricto. Lee references/api.md antes de consumir programáticamente el objeto academic.

Usa map antes de crawl. Mantén los valores predeterminados de rastreo a menos que el usuario necesite una sección pequeña y específica de documentación. El rastreo es HTML estático, mismo host, como máximo ocho páginas y profundidad dos; no es una herramienta de automatización de navegador.

Para investigación profunda, lee references/research-workflow.md antes de elegir subconsultas o interpretar coverage y gaps. Para selección de fuentes y verificación de citas, lee references/source-quality.md.

Si el script incluido no está en el directorio de trabajo actual, resuélvelo en relación con este SKILL.md en lugar de asumir que scripts/ existe en el proyecto del usuario.

El cliente primero verifica AIFINDERKIT_API_KEY para una clave en línea. Si no está configurada, el cliente lee el archivo protegido seleccionado por AIFINDERKIT_API_KEY_FILE, o ~/.config/aifinderkit/credentials por defecto. El configure interactivo lee sin eco; configure --key-stdin admite tuberías de gestores de secretos. Ambos escriben en modo 0600 fuera del Skill y del proyecto actual. Nunca pases una clave como argumento de línea de comandos.

Si un endpoint devuelve 401, pide al usuario que configure una clave de búsqueda válida. Si devuelve 429, informa del límite y no reintentes en bucle. Si warnings indica que una fuente no está disponible, indica que el conjunto de resultados se ha degradado en lugar de asumir una agregación completa.

Lee references/api.md solo cuando se necesiten esquemas exactos, asignaciones de endpoints o comportamiento de errores.