Skip to content

enihcam/aur-skills / skills/aur-rpc

aur-rpc

Verified

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.

Skill: aur-rpc

Purpose

Interact with the 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 fieldMeaning
name-desc (default)Match against Name and Description
nameMatch against Name only
maintainerMatch against Maintainer (empty arg= → orphan list)
comaintainersMatch against comaintainer usernames
dependsPackages whose Depends contains the keyword
makedependsPackages whose MakeDepends contains the keyword
optdependsPackages whose OptDepends contains the keyword
checkdependsPackages whose CheckDepends contains the keyword
providesPackages whose Provides contains the keyword
conflictsPackages whose Conflicts contains the keyword
replacesPackages whose Replaces contains the keyword
groupsMatch against Groups
submitterMatch 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:

{
  "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)

FieldTypeMeaning
IDintPer-package ID
NamestrPackage name (within its base)
PackageBaseIDintBase ID
PackageBasestrBase name (used in URLs, git clones, requests)
VersionstrCurrent pkgver-pkgrel
Descriptionstrpkgdesc
URLstrUpstream URL
NumVotesintVote count
PopularityfloatPopularity score
OutOfDateint | nullUnix timestamp if flagged out-of-date, else null
Maintainerstr | nullnull if orphaned
FirstSubmittedintUnix timestamp
LastModifiedintUnix timestamp
URLPathstrSnapshot URL fragment: /cgit/aur.git/snapshot/<pkgbase>.tar.gz

multiinfo only

FieldType
Dependsstring[]
MakeDependsstring[]
OptDependsstring[]
CheckDependsstring[]
Conflictsstring[]
Providesstring[]
Replacesstring[]
Groupsstring[]
Licensestring[]
Keywordsstring[]

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.

ArchiveFormat
packages.gzOne package name per line
pkgbase.gzOne package base per line
users.gzOne username per line
packages-meta-v1.json.gzFull type=search JSON for every package
packages-meta-ext-v1.json.gzFull type=multiinfo JSON (with all relation fields)

Supports Last-Modified and ETag — use them for incremental updates.

Examples

# 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_interface
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall