القائمة
Resolve avatars through unavatar API for GitHub, X/Twitter, Instagram, Apple Music, email, username, domain, fallbacks, JSON, TTL, and UI profile images.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Validate uncommitted changes in this skills repo before committing. Use when the user invokes /check-local-changes, asks to check, review, or validate local/uncommitted/pending changes, or before committing a new or modified skill.
Execute a remote agent skill from a skills.sh or GitHub URL without installing it on the system. Use when the user invokes /run-skill <url>, shares a skills.sh link, points to a SKILL.md on GitHub, or asks to run/try/test a skill one-off without adding it to their machine.
Automate browserless/Puppeteer headless Chrome for screenshots, PDFs, HTML/text extraction, status checks, Lighthouse audits, and browser pipelines.
Create project-local skills for Cursor and Claude Code when users ask to create, add, or update reusable repo instructions.
Retrieve normalized HTML from URLs with fetch or headless prerender for JS pages, absolute URL rewriting, and metadata extraction pipelines.
Tune Kubernetes HPA, topology spread, requests, and scale-down behavior for cluster cost audits, incidents, replica/node issues, and over-reservation.
| name | unavatar-api |
| description | Resolve avatars through unavatar API for GitHub, X/Twitter, Instagram, Apple Music, email, username, domain, fallbacks, JSON, TTL, and UI profile images. |
unavatar.io resolves user avatars from 40+ platforms via a single endpoint. Supports lookup by email, username, or domain. For email-shaped input with no provider prefix, the API auto-resolves in order: Gravatar, then GitHub.
https://unavatar.io
| Input | Pattern | Example |
|---|---|---|
| email (auto) | /user@example.com | https://unavatar.io/hello@microlink.io (Gravatar → GitHub) |
/gravatar/user@example.com | https://unavatar.io/gravatar/hello@microlink.io | |
/github/user@example.com | https://unavatar.io/github/sindresorhus@gmail.com | |
| username | /provider/username | https://unavatar.io/github/kikobeats |
| domain | /provider/domain.com | https://unavatar.io/google/reddit.com |
Use /:provider/:key for a specific provider, or pass an email as the only path segment for automatic resolution. Details: unavatar.io/email.
x-api-key header, usage-based billing at $0.001/tokencurl -H "x-api-key: YOUR_API_KEY" https://unavatar.io/instagram/kikobeats
| Proxy tier | Tokens | Cost |
|---|---|---|
| Origin | 1 | $0.001 |
| Datacenter | +2 | $0.003 |
| Residential | +4 | $0.007 |
Response headers: x-proxy-tier, x-unavatar-cost, x-pricing-tier.
curl -H "x-api-key: KEY" https://unavatar.io/key/usagecurl -H "x-api-key: KEY" https://unavatar.io/key/rotatenumber | string'24h''1h' to '28d'Cache duration for the resolved avatar. The avatar is considered fresh until TTL expiration, then recomputed on next request.
e.g., https://unavatar.io/kikobeats?ttl=1h
string | booleanCustom fallback image when avatar can't be resolved. Accepts:
false to disable fallback (returns 404 instead)https://unavatar.io/github/37t?fallback=https://avatar.vercel.sh/37t?size=400
https://unavatar.io/github/37t?fallback=false
https://unavatar.io/github/37t?fallback=data:image/gif;base64,R0lGODlhAQABAIAAAP///wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==
booleanReturns JSON payload instead of image content.
e.g., https://unavatar.io/kikobeats?json
When json=true is passed, responses follow a predictable shape:
| Field | Type | Present in | Description |
|---|---|---|---|
| status | string | all JSON responses | One of: success, fail, error. |
| message | string | all JSON responses | Human-readable summary for display/logging. |
| data | object | success | Response payload for successful requests. |
| code | string | fail, error | Stable machine-readable error code. |
| more | string (URL) | most fail/error responses | Documentation URL with troubleshooting details. |
| report | string | some error responses | Support contact channel (e.g., mailto:). |
| Header | Purpose |
|---|---|
| x-pricing-tier | free or pro — the plan used for this request |
| x-timestamp | Server timestamp when request was received |
| x-unavatar-cost | Token cost of the request (avatar routes only) |
| x-proxy-tier | Proxy tier used: origin, datacenter, or residential |
| x-rate-limit-limit | Maximum requests allowed per window (free tier only) |
| x-rate-limit-remaining | Remaining requests in current window (free tier only) |
| x-rate-limit-reset | UTC epoch seconds when window resets (free tier only) |
| retry-after | Seconds until rate limit resets (only on 429 responses) |
Client-side issues return status: "fail" (HTTP 4xx). Service-side issues return status: "error" (HTTP 5xx).
| HTTP | Code | Typical trigger |
|---|---|---|
| 400 | ESESSIONID | Missing session_id in /checkout/success |
| 400 | ESESSION | Checkout session not paid or not found |
| 400 | ESIGNATURE | Missing stripe-signature header |
| 400 | EWEBHOOK | Invalid/failed Stripe webhook processing |
| 400 | EAPIKEYVALUE | Missing apiKey query parameter |
| 400 | EAPIKEYLABEL | Missing label query parameter |
| 401 | EEMAIL | Invalid or missing authenticated email |
| 401 | EUSERUNAUTHORIZED | Missing/invalid auth for protected routes |
| 401 | EAPIKEY | Invalid x-api-key |
| 403 | ETTL | Custom ttl requested without pro plan |
| 403 | EPRO | Provider restricted to pro plan |
| 404 | ENOTFOUND | Route not found |
| 404 | EAPIKEYNOTFOUND | API key not found |
| 409 | EAPIKEYEXISTS | Custom API key already exists |
| 409 | EAPIKEYLABELEXISTS | API key label already exists |
| 409 | EAPIKEYMIN | Attempt to remove last remaining key |
| 429 | ERATE | Free-tier daily rate limit exceeded |
| 500 | ECHECKOUT | Stripe checkout session creation failed |
| 500 | EAPIKEYFAILED | API key retrieval after checkout failed |
| 500 | EINTERNAL | Unexpected internal server failure |
Providers are grouped by input type.
| Provider | username | domain | |
|---|---|---|---|
| Apple Music | ✓ | ||
| Behance | ✓ | ||
| Bluesky | ✓ | ||
| DeviantArt | ✓ | ||
| Discord | ✓ | ||
| Dribbble | ✓ | ||
| DuckDuckGo | ✓ | ||
| GitHub | ✓ | ✓ | |
| GitLab | ✓ | ||
| ✓ | |||
| Gravatar | ✓ | ||
| ✓ | |||
| Ko-fi | ✓ | ||
| ✓ | |||
| Mastodon | ✓ | ||
| Medium | ✓ | ||
| Microlink | ✓ | ||
| OnlyFans | ✓ | ||
| OpenStreetMap | ✓ | ||
| Patreon | ✓ | ||
| ✓ | |||
| Printables | ✓ | ||
| ✓ | |||
| Snapchat | ✓ | ||
| SoundCloud | ✓ | ||
| Spotify | ✓ | ||
| Substack | ✓ | ||
| Telegram | ✓ | ||
| Threads | ✓ | ||
| TikTok | ✓ | ||
| Twitch | ✓ | ||
| Vimeo | ✓ | ||
| ✓ | |||
| X/Twitter | ✓ | ||
| YouTube | ✓ |
Apple Music supports type:id format. Without explicit type, it searches artist then song:
/apple-music/daft%20punkartist: /apple-music/artist:daft%20punk or /apple-music/artist:5468295album: /apple-music/album:discovery or /apple-music/album:78691923song: /apple-music/song:harder%20better%20faster%20stronger or /apple-music/song:697195787Spotify supports type:id format (default type: user):
user: /spotify/kikobeatsartist: /spotify/artist:6sFIWsNpZYqbRiDnNOkZCAplaylist: /spotify/playlist:37i9dQZF1DXcBWIGoYBM5Malbum: /spotify/album:4aawyAB9vmqN3uQ7FjRGTyshow: /spotify/show:6UCtBYL29hRg064d4i5W2iepisode: /spotify/episode:512ojhOuo1ktJprKbVcKyQtrack: /spotify/track:11dFghVXANMlKmJXsNCbNlLinkedIn supports type:id format (default type: user):
user: /linkedin/user:wesboscompany: /linkedin/company:microlinkhqWhatsApp supports type:id format:
channel: /whatsapp/channel:0029VaARuQ7KwqSXh9fiMc0mchat: /whatsapp/chat:D2FFycjQXrEIKG8qQjbwZzYouTube accepts handle, legacy username, or channel ID. Input starting with UC and 24 characters long is treated as a channel ID:
/youtube/casey/youtube/UC_x5XG1OV2P6uZZ5FSM9TtwFor individual provider examples, see providers.md.