CommunityRedacción y edicióngithub.com

prokerala/agent-skills

Habilidades del agente para construir integraciones con la API de Astrología Prokerala.

¿Qué es agent-skills?

Este conjunto de habilidades permite a un agente de IA (como Claude Code, Cursor o Codex) construir integraciones completas con la API de Astrología Prokerala v2 utilizando su SDK oficial de PHP. Proporciona acceso a 99 servicios astrológicos a través de clases tipadas, manejo de autenticación OAuth2, caché de tokens opcional (PSR-16) y resultados estructurados con getters. Es útil para desarrolladores que necesitan automatizar consultas astrológicas (como cartas natales, horóscopos, etc.) en sus aplicaciones PHP. El agente puede guiar al usuario desde la instalación y configuración inicial hasta el uso de servicios específicos, y también explica cómo manejar excepciones comunes como límites de tasa o créditos agotados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add prokerala/agent-skills

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

SDK de PHP para Astrología Prokerala

prokerala/astrology-sdk es el cliente oficial de PHP para la API de Astrología Prokerala v2. Proporciona una clase de servicio tipada por endpoint, abstracción HTTP PSR-18/17, caché de tokens opcional PSR-16 y objetos de resultado tipados con getters.

Repositorio fuente: https://github.com/prokerala/astrology-sdk

Cómo Usar Esta Habilidad

  • Consumir el SDK (instalar, arrancar, primera llamada): lee references/getting-started.md.
  • Encontrar la clase de servicio adecuada para un endpoint: lee references/services.md (los 99 servicios mapeados a rutas de la API).
  • Modificar o extender el SDK (nuevos endpoints, clases de resultado, pruebas): lee references/maintainer-guide.md.
  • Los parámetros de los endpoints, enumeraciones y esquemas de respuesta están documentados en la habilidad complementaria de la API prokerala-astrology-api; esta habilidad del SDK no los duplica.

Requisitos

  • PHP >= 8.0
  • Paquetes de Composer: prokerala/astrology-sdk más una implementación PSR-17/PSR-18 (por ejemplo, nyholm/psr7 + guzzlehttp/guzzle) y opcionalmente una caché PSR-16 (por ejemplo, symfony/cache) para el almacenamiento en caché de tokens.

Referencia Rápida

use GuzzleHttp\Client as HttpClient;
use Nyholm\Psr7\Factory\Psr17Factory;
use Prokerala\Common\Api\Authentication\Oauth2;
use Prokerala\Common\Api\Client;
use Prokerala\Api\Astrology\Location;
use Prokerala\Api\Astrology\Service\Kundli;

$psr17Factory = new Psr17Factory();
$httpClient = new HttpClient();

// 6º argumento opcional: cualquier caché PSR-16; almacena en caché el token OAuth hasta su expiración.
$authClient = new Oauth2($clientId, $clientSecret, $httpClient, $psr17Factory, $psr17Factory, $cache);
$client = new Client($authClient, $httpClient, $psr17Factory);

$location = new Location(23.1765, 75.7885, 0, new DateTimeZone('Asia/Kolkata'));
$datetime = new DateTimeImmutable('2022-03-17T10:50:40+05:30');

$result = (new Kundli($client))->process($location, $datetime);
$nakshatra = $result->getNakshatraDetails()->getNakshatra()->getName();
  • Los servicios toman el Client en su constructor y exponen un único método process(...).
  • Pasa las coordenadas mediante Location; las fechas-hora como DateTimeImmutable (el SDK las formatea internamente en ISO 8601).
  • $client->getCreditUsed() devuelve los créditos de API consumidos por la última llamada (del encabezado X-Api-Credits).

Excepciones

Todas en Prokerala\Common\Api\Exception, lanzadas por Client::process():

ExcepciónEstado HTTPSignificado
ValidationException400Entrada no válida; contiene la lista completa de errors
AuthenticationException401Credenciales incorrectas o caducadas
QuotaExceededException403Créditos de API agotados
RateLimitExceededException429Demasiadas solicitudes; esperar
ServerException500Fallo del servidor
ExceptionotroClase base; captura general

TokenExpiredException se maneja internamente (el cliente renueva el token y reintenta una vez); el código consumidor no necesita capturarla.

Skills relacionados