Quota Orbit사용 가이드

Codex 공개 초기화 소식을 도구에 연동하기: HTTP API, RSS, MCP

공개 HTTP API, RSS, MCP로 Codex 초기화 공지를 조회하고 원문, 시간, 출처 상태를 함께 확인하세요. 표준 라이브러리를 사용하는 읽기 전용 Python 예제를 제공합니다. API Key가 필요하지 않으며 개인 계정의 한도는 제공하지 않습니다.

마지막 확인: 한국어

가장 간단한 연동 방법 선택하기

리더로 소식을 읽으려면 RSS, 스크립트나 대시보드에 연결하려면 HTTP API, MCP를 지원하는 AI 도구에서 조회하려면 원격 MCP를 사용하세요. 모두 기존 공개 소식을 읽으며 계정을 초기화하거나 개인 잔여 한도를 제공하지 않습니다.

HTTP: 읽기 전용 Python 쿼리 한 번 실행하기

아래 코드를 check_codex_reset.py로 저장하고 Python 3.10 이상이 설치된 환경에서 python3 check_codex_reset.py를 실행하세요. Python 표준 라이브러리만 사용하며 가입, API Key, Codex 계정 인증 정보가 필요하지 않습니다. 기존 데이터를 한 번 읽을 뿐, 주기적 조회나 구독을 설정하지 않습니다.

Python · 표준 라이브러리 · 읽기 전용 GET
import json
from datetime import datetime, timezone
from urllib.error import HTTPError, URLError
from urllib.request import urlopen

url = 'https://www.starshoreai.com/quota-orbit/api/v1/latest.json'
try:
    with urlopen(url, timeout=15) as response:
        data = json.load(response)
    if not isinstance(data, dict) or data.get('schema_version') != 1:
        raise ValueError('Unsupported response schema')
    event = data.get('event')
    if event is not None and not isinstance(event, dict):
        raise ValueError('Invalid event field')
except HTTPError as error:
    error.close()
    message = 'Wait at least 60 seconds before retrying' if error.code == 429 else 'Retry later'
    raise SystemExit(f'HTTP {error.code}: {message}; a failed request does not mean no reset occurred.')
except (URLError, OSError, ValueError) as error:
    raise SystemExit(f'Read failed: {error}; reset status cannot be inferred from this failure.')

checked_text = data.get('source_checked_at')
try:
    checked = datetime.fromisoformat(checked_text.replace('Z', '+00:00'))
    if checked.tzinfo is None:
        raise ValueError('Source check time has no timezone')
    age = (datetime.now(timezone.utc) - checked).total_seconds()
    fresh = data.get('source_healthy') is True and 0 <= age <= 30 * 60
except (AttributeError, TypeError, ValueError, OverflowError):
    fresh = False

print('Source checked at: ', checked_text or 'unknown')
print('Source is healthy and fresh' if fresh else 'Source is unhealthy, unknown or stale: historical reference only')
if event is None:
    print('No record returned; this does not mean no reset occurred.')
else:
    print('Public announcement:')
    print(json.dumps(event, ensure_ascii=False, indent=2))
    links = event.get('source_urls')
    for link in links if isinstance(links, list) else []:
        if isinstance(link, str) and link.startswith('https://'):
            print('Original post or supporting source: ', link)
print('This is public information, not a check of your personal account quota.')

출처 확인 시간, 상태 판정, 공개 이벤트 필드, 원문 링크가 출력되어야 합니다.latest 는 마지막으로 업데이트된 이벤트를 뜻하며 반드시 완료 공지는 아닙니다. event: null 은 반환된 기록이 없다는 뜻이며 오늘 초기화가 없을 것이라는 의미는 아닙니다. completed 도 공개 소식에서 완료를 알렸다는 뜻일 뿐입니다.

출처가 정상적이지 않거나 확인 시간이 불명확하거나 30분 넘게 지났다면 과거 기록 확인용으로만 사용하세요. 조회에 실패하면 기존 데이터를 보관하되 오래된 데이터임을 표시하고, 이를 “초기화 없음”으로 바꾸어 해석하지 마세요.

더 많은 기록이 필요하면 페이지 나누기와 캐시 사용하기

이벤트 목록 주소에서 시작해 응답의 next를 따라가며, null이면 멈춥니다. 상대 주소는 https://www.starshoreai.com/quota-orbit/ 을 기준으로 해석합니다. 중복 제거에는 event_id 를 사용하고, revision 이 바뀌면 기존 기록을 업데이트합니다. 현재는 사용자 지정 쿼리 매개변수를 지원하지 않습니다.

60초 이상의 간격으로 조회하고 캐시를 사용하는 것을 권장합니다. ETag, If-None-Match , 304를 지원합니다. 429 응답을 받으면 최소 60초 기다린 뒤 재시도 간격을 점차 늘리세요. 전체 필드와 오류 처리는 다음 문서를 참고하세요: 연동 문서. 위의 일회성 예제는 영구 캐시나 자동 재시도를 구현하지 않습니다.

RSS: 리더에 구독 주소 추가하기

구독 주소 https://www.starshoreai.com/quota-orbit/rss.xml 을 RSS 2.0을 지원하는 리더에 추가하세요. 정상적으로 읽으면 공개 이벤트의 제목, 시간, 상태, 원문 링크가 표시됩니다.

피드는 최근 공개 이벤트 20건을 제공하며 전체 기록은 아닙니다. 항목이 수정되어도 식별자는 유지됩니다. 다시 알림을 보낼지는 리더의 새로고침 및 알림 설정에 달려 있습니다. 오래된 항목이 조회된다고 해서 출처가 현재 정상이라는 뜻은 아닙니다.

MCP: AI 답변에 원문 링크와 시간 남기기

Streamable HTTP를 지원하는 클라이언트에서 해당 클라이언트의 안내에 따라 원격 MCP 서비스를 추가하세요. 주소: https://www.starshoreai.com/quota-orbit/mcp. API Key는 필요하지 않습니다.

연결 후 latest_reset_signal 와 list_reset_signals 두 읽기 전용 도구가 표시되는지 확인한 뒤 다음과 같이 조회하세요:

마지막으로 업데이트된 Codex 공개 초기화 소식을 조회하고 소식 유형, 상태, 원문 링크, 출처 확인 시간을 알려주세요. 출처에 이상이 있거나 데이터가 오래되었다면 명시하고, 제 개인 한도가 복구되었다고 추정하지 마세요.

결과에는 확인 가능한 출처와 데이터의 최신성이 포함되어야 하며, “초기화 완료”라는 결론만으로는 충분하지 않습니다. 클라이언트가 해당 전송 방식을 지원하지 않으면 문서의 로컬 MCP 연동 안내에 따라 설정하세요. 일반 웹페이지 주소를 MCP 연결 주소로 사용하지 마세요.

출처와 확인 날짜

아래 공개 자료는 2026-10-17에 확인했습니다. 계정과 클라이언트의 현재 표시는 해당 환경에서 별도로 확인해야 합니다.

Quota Orbit은 OpenAI의 공식 제품이 아닌 독립 도구입니다. 공개 웹페이지와 연동 인터페이스는 개인 한도를 읽지 않으며, 개인 한도 복구를 보장하거나 초기화 확률을 예측하지 않습니다.

← 공개 초기화 소식으로 돌아가기 · API 문서 (중국어) · 모든 가이드