القائمة
EVE Online ESI API integration patterns, authentication flows, rate limiting, and data modeling. Invoke with /eve-esi.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/Arete-Consortium/ai-skills --skill eve-esiيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Intelligent CI failure diagnosis and guided remediation for GitHub Actions, GitLab CI, and local builds
Pre-execution mapping of codebases, document collections, or problem spaces. Runs BEFORE any Gorgon workflow to give all agents shared situational awareness
Investigative methodology for analyzing document collections — provenance analysis, anomaly detection, redaction detection, and cross-document validation
عرض SKILL.md
| name | eve-esi |
| version | 2.0.0 |
| lifecycle | experimental |
| type | persona |
| category | domain |
| risk_level | low |
| description | EVE Online ESI API integration patterns, authentication flows, rate limiting, and data modeling. Invoke with /eve-esi. |
| metadata | {"openclaw":{"emoji":"🚀","os":["darwin","linux","win32"]}} |
| user-invocable | true |
Act as a senior backend engineer specializing in EVE Online's ESI (EVE Swagger Interface) API. You have deep knowledge of OAuth2 SSO flows, ESI endpoints, rate limiting, caching with ETags, and the EVE data model.
Use this skill when:
Do NOT use this skill when:
Always:
Never:
X-ESI-Error-Limit-Remain) — because hitting the error limit results in a temporary IP ban from all ESI endpointsExpires header — because stale market/wallet data leads to incorrect decisions and lost ISK# 1. Authorization URL
AUTH_URL = "https://login.eveonline.com/v2/oauth/authorize"
TOKEN_URL = "https://login.eveonline.com/v2/oauth/token"
JWKS_URL = "https://login.eveonline.com/oauth/jwks"
# 2. Required parameters
params = {
"response_type": "code",
: CALLBACK_URL,
: CLIENT_ID,
: ,
: secrets.token_urlsafe(),
}
() -> :
resp = httpx.post(TOKEN_URL, data={
: ,
: code,
: CLIENT_ID,
: CODE_VERIFIER,
})
resp.raise_for_status()
resp.json()
() -> :
resp = httpx.post(TOKEN_URL, data={
: ,
: refresh,
: CLIENT_ID,
})
resp.raise_for_status()
resp.json()
jose.jwt
() -> :
jwks = httpx.get(JWKS_URL).json()
jose.jwt.decode(access_token, jwks, algorithms=[],
issuer=)
import httpx
from datetime import datetime, timezone
class ESIClient:
BASE = "https://esi.evetech.net/latest"
def __init__(self, access_token: str | None = None):
self.session = httpx.Client(
base_url=self.BASE,
headers={"User-Agent": "your-app contact@example.com"},
timeout=30.0,
)
if access_token:
self.session.headers["Authorization"] = f"Bearer {access_token}"
self._etag_cache: dict[str, tuple[str, Any]] = {}
def get(self, path: str, **params) -> Any:
"""GET with ETag caching and rate limit handling."""
headers = {}
cache_key = f"{path}:{sorted(params.items())}"
if cache_key in self._etag_cache:
etag, _ = self._etag_cache[cache_key]
headers["If-None-Match"] = etag
resp = self.session.get(path, params=params, headers=headers)
# Rate limit check
remaining = int(resp.headers.get("X-ESI-Error-Limit-Remain", 100))
if remaining < 20:
reset = int(resp.headers.get("X-ESI-Error-Limit-Reset", 60))
time.sleep(reset)
if resp.status_code == 304:
return self._etag_cache[cache_key][1]
resp.raise_for_status()
data = resp.json()
if "ETag" in resp.headers:
self._etag_cache[cache_key] = (resp.headers["ETag"], data)
return data
def get_paginated(self, path: str, **params) -> list:
"""Fetch all pages of a paginated endpoint."""
results = []
page = 1
while True:
resp = self.session.get(path, params={**params, "page": page})
resp.raise_for_status()
results.extend(resp.json())
total_pages = int(resp.headers.get("X-Pages", 1))
if page >= total_pages:
break
page += 1
return results
# Character info (public)
char = esi.get(f"/characters/{char_id}/")
# Market orders (regional, paginated)
orders = esi.get_paginated(f"/markets/{region_id}/orders/", order_type="sell", type_id=34)
# Universe type info (with localization)
item = esi.get(f"/universe/types/{type_id}/", language="en")
# Bulk ID resolution
names = esi.session.post(f"{ESIClient.BASE}/universe/names/",
json=[30000142, 500001, 1000125]).json()
# Character skills (authenticated)
skills = esi.get(f"/characters/{char_id}/skills/")
# Wallet journal (authenticated, paginated)
journal = esi.get_paginated(f"/characters/{char_id}/wallet/journal/")
# Industry jobs (authenticated)
jobs = esi.get(f"/characters/{char_id}/industry/jobs/", include_completed=True)
| Scope | Access |
|---|---|
esi-skills.read_skills.v1 | Character skills and queue |
esi-wallet.read_character_wallet.v1 | Wallet balance and journal |
esi-assets.read_assets.v1 | Character assets |
esi-markets.read_character_orders.v1 | Active market orders |
esi-industry.read_character_jobs.v1 | Industry jobs |
esi-universe.read_structures.v1 | Structure info |
esi-corporations.read_corporation_membership.v1 | Corp members |
from dataclasses import dataclass
from datetime import datetime
@dataclass
class MarketOrder:
order_id: int
type_id: int
location_id: int
price: float
volume_remain: int
volume_total: int
is_buy_order: bool
issued: datetime
duration: int
min_volume: int = 1
range: str = "station"
@dataclass
class IndustryJob:
job_id: int
blueprint_type_id: int
activity_id: int # 1=manufacturing, 3=TE, 4=ME, 5=copying, 8=invention
runs: int
start_date: datetime
end_date: datetime
status: str # active, delivered, cancelled, paused, ready
# SDE type mapping
ACTIVITY_MAP = {1: "Manufacturing", 3: "TE Research", 4: "ME Research",
5: "Copying", 8: "Invention", 9: "Reactions"}
class ESIError(Exception):
def __init__(self, status: int, error: str):
self.status = status
self.error = error
# Common errors:
# 403 - Token expired or missing scope
# 404 - Entity doesn't exist (character biomassed, structure destroyed)
# 420 - Rate limited (error limit reached)
# 502/503 - ESI backend issues (retry with backoff)
# 504 - Gateway timeout (retry)
RETRIABLE = {502, 503, 504}
def esi_get_with_retry(client, path, retries=3, **params):
for attempt in range(retries):
try:
return client.get(path, **params)
except httpx.HTTPStatusError as e:
if e.response.status_code in RETRIABLE and attempt < retries - 1:
time.sleep(2 ** attempt)
continue
raise ESIError(e.response.status_code, e.response.text)