Community写作与编辑github.com

prokerala/agent-skills

用于构建与 Prokerala 占星 API 集成的智能体技能。

agent-skills 是什么?

该技能为 AI 智能体(如 Claude Code、Cursor、Codex)提供了与 Prokerala 占星 API v2 进行集成的能力,通过其官方 PHP SDK (`prokerala/astrology-sdk`) 实现。它封装了 99 个 API 端点,每个端点对应一个类型化的服务类,并支持 PSR-18/17 HTTP 抽象、可选的 PSR-16 令牌缓存以及类型化的结果对象。对于构建需要基于出生日期和地点计算星盘(Kundli)、纳克沙特拉(Nakshatra)等占星数据的应用或自动化流程的开发者和 AI 代理而言,此技能非常有用。技能文档结构清晰,提供了快速入门指南、服务类参考、维护者指南以及详细的异常处理说明。支持的平台包括所有使用 PHP 8.0+ 的环境,如基于 Composer 的项目或 Web 应用。

兼容平台~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 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Prokerala 占星 PHP SDK

prokerala/astrology-sdk 是 Prokerala 占星 API v2 的官方 PHP 客户端。它为每个端点提供了类型化的服务类、PSR-18/17 HTTP 抽象、可选的 PSR-16 令牌缓存以及带有 getter 方法的类型化结果对象。

源代码仓库: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();

// 可选的第六个参数:任何 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 在内部处理(客户端会刷新令牌并重试一次);消费代码无需捕获它。

相关技能