Community라이팅 & 에디팅github.com

prokerala/agent-skills

Prokerala 점성술 API와 통합을 구축하기 위한 에이전트 스킬입니다.

agent-skills란 무엇인가요?

이 스킬은 PHP 8.0+ 환경에서 Prokerala 점성술 API v2와 통합하는 공식 PHP SDK(`prokerala/astrology-sdk`)를 기반으로 합니다. 99개의 엔드포인트 각각에 대해 타입화된 서비스 클래스, PSR-18/17 HTTP 추상화, 선택적 PSR-16 토큰 캐싱, 게터가 있는 타입화된 결과 객체를 제공합니다. 에이전트가 SDK의 설치, 부트스트래핑, 첫 호출을 하는 방법은 `references/getting-started.md`에서, 특정 엔드포인트에 적합한 서비스 클래스를 찾는 방법은 `references/services.md`에서, SDK 자체를 수정하거나 확장하는 방법은 `references/maintainer-guide.md`에서 안내합니다. 에이전트가 Kundli(출생 차트) 서비스를 호출하여 위도/경도와 DateTimeImmutable 객체로 위치와 시간을 전달하고, 결과에서 나크샤트라 이름을 추출하는 과정을 포함한 빠른 참조 코드 예제도 제공합니다. API 호출 중 발생할 수 있는 ValidationException, AuthenticationException, QuotaExceededException, RateLimitExceededException, ServerException 등 다양한 예외 상황을 명확히 구분하여 반환하며, TokenExpiredException은 클라이언트가 내부적으로 자동 갱신하여 처리합니다. 엔드포인트 파라미터, 열거형, 응답 스키마는 동반 API 스킬 `prokerala-astrology-api`에 문서화되어 중복을 피합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add prokerala/agent-skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Prokerala 점성술 PHP SDK

prokerala/astrology-sdk는 Prokerala Astrology API v2의 공식 PHP 클라이언트입니다. 엔드포인트별 타입화된 서비스 클래스, PSR-18/17 HTTP 추상화, 선택적 PSR-16 토큰 캐싱, 게터가 있는 타입화된 결과 객체를 제공합니다.

소스 저장소: https://github.com/prokerala/astrology-sdk

이 스킬 사용 방법

  • SDK 사용 (설치, 부트스트래핑, 첫 호출): references/getting-started.md를 읽으십시오.
  • 엔드포인트에 적합한 서비스 클래스 찾기: references/services.md를 읽으십시오 (99개 서비스 모두 API 경로에 매핑됨).
  • SDK 수정 또는 확장 (새 엔드포인트, 결과 클래스, 테스트): references/maintainer-guide.md를 읽으십시오.
  • 엔드포인트 파라미터, 열거형, 응답 스키마는 동반 API 스킬 prokerala-astrology-api에 문서화되어 있습니다. SDK 스킬은 이를 중복하지 않습니다.

요구 사항

  • PHP >= 8.0
  • Composer 패키지: prokerala/astrology-sdk 및 PSR-17/PSR-18 구현체 (예: nyholm/psr7 + guzzlehttp/guzzle), 선택적으로 토큰 캐싱을 위한 PSR-16 캐시 (예: symfony/cache).

빠른 참조

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번째 인수: 모든 PSR-16 캐시; 만료 시까지 OAuth 토큰을 캐싱합니다.
$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();
  • 서비스는 생성자에서 Client를 받고 단일 process(...) 메서드를 노출합니다.
  • 좌표는 Location을 통해 전달하고, 날짜-시간은 DateTimeImmutable로 전달합니다 (SDK는 내부적으로 ISO 8601 형식으로 변환).
  • $client->getCreditUsed()는 마지막 호출에 사용된 API 크레딧을 반환합니다 (X-Api-Credits 헤더에서 가져옴).

예외 처리

모두 Prokerala\Common\Api\Exception에 있으며, Client::process()에서 발생합니다.

예외HTTP 상태의미
ValidationException400잘못된 입력; 전체 errors 목록을 포함합니다
AuthenticationException401잘못되었거나 만료된 자격 증명
QuotaExceededException403API 크레딧 소진
RateLimitExceededException429너무 많은 요청; 잠시 멈춤
ServerException500서버 측 오류
Exception기타기본 클래스; 모든 예외 포착

TokenExpiredException은 내부적으로 처리됩니다 (클라이언트가 토큰을 갱신하고 한 번 재시도). 사용자 코드에서 이를 포착할 필요가 없습니다.

관련 스킬