AstroWay/api v2.74.2 · ko
모든 시스템 정상 작동 중

// sdk · 공식 클라이언트

11개 언어용 SDK.

완전한 타입 지원, retry 로직, intelligent rate-limiting이 포함된 공식 클라이언트. cURL이나 헤더 수동 처리 없이 4줄 코드로 요청 가능. 8개 언어가 프로덕션용, 3개는 개발 중이며, 모두 OpenAPI 3.1에서 자동 생성됩니다.

릴리스됨

// AstroWay에서 관리 · OpenAPI 동기화 실시간 반영
mcp-hosted 릴리스됨

호스팅 MCP — 클로드 웹/데스크톱/커서용 제로 설치

mcp.astroway.info/mcp에서 호스팅 스트리밍 HTTP 엔드포인트 제공 — 로컬 설치 없이 npm 패키지와 동일한 700+ 도구 카탈로그. 하나의 URL, 하나의 Bearer 헤더로 AI 클라이언트가 AstroWay 생태계를 모두 확인. 멀티 테넌트:Bearer 키 소유 계정에서 크레딧 차감.

https://mcp.astroway.info/mcp SDK 가이드 읽기 →
mcp 릴리스됨

Claude / Cursor / GPT용 MCP 서버 (stdio)

공식 @astroway/mcp: AstroWay API의 700개 이상의 모든 엔드포인트를 AI 에이전트의 도구로 노출합니다. Claude Desktop, Cursor, GPT MCP 클라이언트와 호환됩니다. stdio 모드 — 키가 로컬에 남아 있어 네트워크 홉 없이 사용 가능합니다. 즉시 설치가 필요 없을 때는 호스팅된 엔드포인트를 사용하세요.

npx -y @astroway/mcp SDK 가이드 읽기 →
typescript 릴리스됨

AstroWay API용 TypeScript SDK

공식 `@astroway/sdk` — `openapi-fetch` 기반 가벼운 래퍼 (~6 KB 런타임). 모든 {endpoints}+ 엔드포인트에 대해 IDE에서 경로 자동완성 + 요청/응답 타입 제공. Stainless 스타일 오류 계층, 408/409/429/5xx 응답 시 자동 재시도, OIDC + SLSA L3 프로비전.

npm install @astroway/sdk SDK 가이드 읽기 →
python 릴리스됨

AstroWay API를 위한 파이썬 SDK

공식 `astroway` on PyPI — `Astroway` (동기) + `AsyncAstroway` (비동기) on top of `httpx`. 동일한 인터페이스 — 클라이언트 모두 동일한 API. Stainless-style 오류 계층, 408/409/429/5xx에 대한 재시도, PEP 561 유형화된 패키지. 파이썬 3.9+, 신뢰할 수 있는 발행자 OIDC.

pip install astroway SDK 가이드 읽기 →
php 릴리스됨

AstroWay API용 PHP SDK

공식 `astroway/sdk` on Packagist — Guzzle 7 + PSR-18 기반. PHP 8.1+(읽기 전용 속성, 생성자 승격). Stainless 스타일 오류 계층, 내장 재시도 미들웨어(408/409/429/5xx), 두 가지 인증 方案(X-Api-Key 기본 또는 Bearer).

composer require astroway/sdk SDK 가이드 읽기 →
react 릴리스됨

@astroway/sdk용 React 동반자

공식 `@astroway/react` on npm — `@astroway/sdk`를 위한 얇은 Stripe 스타일 래퍼. `AstrowayProvider`는 클라이언트를 React 컨텍스트로 올려주며, `useAstroway`, `useAstrowayQuery`, `useNatalChart` 훅은 외부 종속성 없이 SWR 스타일의 `{ data, error, loading }` 트리플을 반환합니다. React 18+, Next.js App Router(via "use client"), Vite, CRA와 함께 작동합니다.

npm install @astroway/react @astroway/sdk react SDK 가이드 읽기 →
symfony 릴리스됨

AstroWay API용 Symfony 번들

공식 `astroway/sdk-symfony` on Packagist — `astroway/sdk` 위에 있는 번들. Symfony Flex를 통해 자동 등록되며, 표준 `config/packages/astroway.yaml`을 통해 구성되며,任意 컨트롤러 또는 서비스에 주입할 수 있는 자동 연결 가능한 `Astroway\Astroway` 서비스를 노출합니다. Symfony 6.4 LTS 및 7.x, PHP 8.1+와 호환됩니다.

composer require astroway/sdk-symfony SDK 가이드 읽기 →
laravel 릴리스됨

AstroWay API용 Laravel ServiceProvider

공식 `astroway/sdk-laravel` on Packagist — ServiceProvider + фасад на вершине `astroway/sdk`. 자동으로 `composer.json` `extra.laravel.providers`를 통해 발견되며, `AstrowayAstroway`는 컨테이너 싱글턴으로 등록되고, 구성은 `php artisan vendor:publish`를 통해 게시됩니다. 컨트롤러에 주입하거나 фас드 `Astroway::post("/chart", ...)`를 사용합니다. Laravel 10/11/12, PHP 8.1+와 함께 작동합니다.

composer require astroway/sdk-laravel SDK 가이드 읽기 →

첫 요청까지 4줄

// TypeScript · 동일한 패턴 Python, PHP, Laravel, Symfony, React에서도 사용
npm install @astroway/sdk 전체 예제 →
import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const { data: chart } = await aw.client.POST('/chart', {
  body: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  },
});

console.log(chart.angles.asc);

곧 출시

// 로드맵 · 출시 시 알림

직접 래퍼

// OpenAPI 3.1 · 원하는 언어, 원하는 규칙

리스트에 없는 언어가 있나요? 모든 엔드포인트는 표준화된 OpenAPI 3.1 스펙으로 제공됩니다. openapi-generator 또는 stainless로 직접 클라이언트를 생성하세요.