enihcam/aur-skills / skills/aur-rpc
aur-rpc
VerifiedQuery the Aurweb RPC interface (v5) to search AUR packages, retrieve package info, and consume the metadata archives. Use when building an AUR helper, verifying upstream state, bulk-fetching package metadata, or integrating with the AUR programmatically.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.6 KB |
SKILL.md
View on GitHub---
name: aur-rpc
description: Query the Aurweb RPC interface (v5) to search AUR packages, retrieve package info, and consume the metadata archives. Use when building an AUR helper, verifying upstream state, bulk-fetching package metadata, or integrating with the AUR programmatically.
license: MIT
---
# Skill: aur-rpc
## Purpose
Interact with the [Aurweb RPC interface](https://wiki.archlinux.org/title/Aurweb_RPC_interface) — the lightweight JSON HTTP API that powers `yay`, `paru`, the AUR web search, and most third-party tooling.
**Base URL:** `https://aur.archlinux.org/rpc/v5/`
## Query Types
Two endpoint shapes:
### Search
```
GET /rpc/v5/search/<keyword>?by=<field>
```
| `by` field | Meaning |
|------------|---------|
| `name-desc` *(default)* | Match against `Name` and `Description` |
| `name` | Match against `Name` only |
| `maintainer` | Match against `Maintainer` (empty `arg=` → orphan list) |
| `comaintainers` | Match against comaintainer usernames |
| `depends` | Packages whose `Depends` contains the keyword |
| `makedepends` | Packages whose `MakeDepends` contains the keyword |
| `optdepends` | Packages whose `OptDepends` contains the keyword |
| `checkdepends` | Packages whose `CheckDepends` contains the keyword |
| `provides` | Packages whose `Provides` contains the keyword |
| `conflicts` | Packages whose `Conflicts` contains the keyword |
| `replaces` | Packages whose `Replaces` contains the keyword |
| `groups` | Match against `Groups` |
| `submitter` | Match against the submitter username |
### Info
```
GET /rpc/v5/info?arg[]=<pkg1>&arg[]=<pkg2>&...
```
URL-encode the brackets as `%5B%5D` when calling by hand.
## Response Envelope
Every response is JSON with the same shape:
```json
{
"version": 5,
"type": "search" | "multiinfo" | "error",
"resultcount": 0,
"results": [...]
}
```
`type: "error"` includes an additional `"error": "..."` string. Errors still return HTTP 200 — check `type`, not the status code.
## Fields
### Always returned (`search` and `multiinfo`)
| Field | Type | Meaning |
|-------|------|---------|
| `ID` | int | Per-package ID |
| `Name` | str | Package name (within its base) |
| `PackageBaseID` | int | Base ID |
| `PackageBase` | str | Base name (used in URLs, git clones, requests) |
| `Version` | str | Current `pkgver-pkgrel` |
| `Description` | str | `pkgdesc` |
| `URL` | str | Upstream URL |
| `NumVotes` | int | Vote count |
| `Popularity` | float | Popularity score |
| `OutOfDate` | int \| null | Unix timestamp if flagged out-of-date, else `null` |
| `Maintainer` | str \| null | `null` if orphaned |
| `FirstSubmitted` | int | Unix timestamp |
| `LastModified` | int | Unix timestamp |
| `URLPath` | str | Snapshot URL fragment: `/cgit/aur.git/snapshot/<pkgbase>.tar.gz` |
### `multiinfo` only
| Field | Type |
|-------|------|
| `Depends` | string[] |
| `MakeDepends` | string[] |
| `OptDepends` | string[] |
| `CheckDepends` | string[] |
| `Conflicts` | string[] |
| `Provides` | string[] |
| `Replaces` | string[] |
| `Groups` | string[] |
| `License` | string[] |
| `Keywords` | string[] |
Fields a package doesn't have are **omitted** (not present as `null`).
## JSONP
Append `?callback=<name>` to wrap the response in a JS function call. Useful from browser-side code only.
## Limits
- HTTP GET URI: max **8190 bytes** (nginx with HTTP/2 enforces **4443 bytes**)
- Search keyword: min **2 characters**
- Search with **≥5000 hits** fails with `"error": "Too many package results."` (no partial results)
- Rate limit: **4000 requests/day per IP**
- `info` with >200 packages needs to be split
## Metadata Archives (Bulk)
For repeated bulk queries, prefer the gzipped metadata archives — much friendlier to the AUR than thousands of RPC calls. All live at `https://aur.archlinux.org/<archive>.gz`, refreshed ~every 5 minutes.
| Archive | Format |
|---------|--------|
| `packages.gz` | One package name per line |
| `pkgbase.gz` | One package base per line |
| `users.gz` | One username per line |
| `packages-meta-v1.json.gz` | Full `type=search` JSON for every package |
| `packages-meta-ext-v1.json.gz` | Full `type=multiinfo` JSON (with all relation fields) |
Supports `Last-Modified` and `ETag` — use them for incremental updates.
## Examples
```bash
# Search for packages matching "neovim"
curl 'https://aur.archlinux.org/rpc/v5/search/neovim'
# Info for multiple packages (URL-encoded brackets)
curl 'https://aur.archlinux.org/rpc/v5/info?arg%5B%5D=yay&arg%5B%5D=paru'
# Orphan packages (empty maintainer). Path /search/ with no keyword 404s —
# use query-string arg= instead. Orphans exceed 5000, so this returns
# {"type":"error","error":"Too many package results.",...} — expected.
curl 'https://aur.archlinux.org/rpc/v5/search?by=maintainer&arg='
# Out-of-date orphans — filter the metadata archive instead
curl -sL https://aur.archlinux.org/packages-meta-v1.json.gz | gzip -dc \
| jq '.[] | select(.Maintainer == null and .OutOfDate != null) | {Name, OutOfDate, Version}'
# Bulk fetch — use the metadata archive once per refresh
curl -O https://aur.archlinux.org/packages-meta-ext-v1.json.gz
```
## Reference Implementation
The Arch Wiki links to canonical Python clients. For new helpers, prefer:
- Batch with the metadata archive, then fall back to RPC for individual package deltas
- Cache aggressively (ETag / `Last-Modified`)
- Respect the 4000/day rate limit — back off on HTTP 429
## Related
- `aur-helpers` — clients built on top of this API
- `aur-audit` — uses RPC to verify `OutOfDate`, popularity, votes before flagging
- `aur-submission` — `URLPath` is the snapshot download link for non-git clients
- Full spec: https://wiki.archlinux.org/title/Aurweb_RPC_interfaceRelated skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |