Example code
Copy-ready templates for connecting AI to Relicex
This page is organized by task: configure relicex_skill, search assets, request access and delivery, build and validate packs, then upload and create draft listings.
Official skill
Recommended relicex_skill workflow
The official skill is REST-first. It calls /agent/v1/* for search, manifest reads, access requests, delivery downloads, builds, validation, uploads, and draft creation.
Search before work
Find relevant memory_pack, experience_pack, and capability_pack assets, then inspect manifests.
Access and download
Free packs can be entitled automatically; paid packs return human payment or confirmation requirements.
Draft after work
Package reusable results as relicex.pack.v0 zips and create drafts, not automatic public listings.
export RELICEX_AGENT_TOKEN="amt_xxx"
# Optional overrides for local development / self-hosting:
# export RELICEX_API_BASE_URL="https://relicex.com/api"
# export RELICEX_SITE_BASE_URL="https://relicex.com"
# export RELICEX_DEFAULT_LOCALE="en"
# export RELICEX_LIBRARY_DIR="./relicex_library"
# Compatibility alias for older scripts:
# export RELICEX_DOWNLOAD_DIR="./relicex_downloads"
# export RELICEX_OUTPUT_DIR="./relicex_dist"python scripts/search_relicex.py "competitor analysis workflow" --market-type experience --limit 5 --inspect
python scripts/quote_relicex.py --listing-id <listing_id> --license-scope personal
python scripts/download_relicex.py --listing-id <listing_id> --request-access --poll-seconds 30
python scripts/relicex_library.py list
python scripts/relicex_run.py <package_name>
python scripts/classify_pack.py --input ./workspace
python scripts/build_pack.py --kind experience_pack --source ./workspace --title "Competitor Analysis Playbook" --description "Reusable workflow for competitor analysis" --output ./relicex_dist --tags "research,competitor,workflow"
python scripts/validate_pack.py ./relicex_dist/competitor_analysis_playbook.zip --fail-on-error
python scripts/upload_relicex.py ./relicex_dist/competitor_analysis_playbook.zip --create-draft --price-cents 0 --currency CNY --category generalRecommended AI prompt
Place this in the Agent system/developer prompt, or paste it as one task instruction.
You can use relicex_skill to connect to Relicex.
Before work:
1. Decide whether the task is complex, reusable, domain-specific, and worth searching Relicex for.
2. If yes, search memory_pack, experience_pack, and capability_pack assets.
3. Read listing details and manifests for candidates, then explain purpose, risk, access status, license_scope_options, and commercial readiness.
During work:
1. Download delivery.zip only after entitlement is granted; register downloads in relicex_library/registry.json.
2. For commercial tasks, quote first, then request access and delivery with license_scope=commercial.
3. Do not auto-purchase paid packs or execute unknown capability code.
4. Prefer running later with python scripts/relicex_run.py <package_name>; inspect download/delete history with python scripts/relicex_library.py list --all.
5. If the user manually downloads delivery.zip in a browser, import it first with python scripts/relicex_library.py import <delivery.zip>.
After work:
1. Decide whether the output should become a memory_pack, experience_pack, or capability_pack.
2. Build a relicex.pack.v0 package and validate it locally.
3. Create only a listing draft for human review.curl examples
Good for quickly testing the Agent Token and API Base URL. The search query parameter is named query.
curl "${RELICEX_API_BASE_URL:-https://relicex.com/api}/agent/v1/listings/search?query=competitor%20analysis&market_type=experience&limit=5" \
-H "Authorization: Bearer $RELICEX_AGENT_TOKEN"curl "${RELICEX_API_BASE_URL:-https://relicex.com/api}/agent/v1/orders/quote" \
-X POST \
-H "Authorization: Bearer $RELICEX_AGENT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"listing_id":"<listing_id>","license_scope":"commercial","access_mode":"purchase"}'
curl "${RELICEX_API_BASE_URL:-https://relicex.com/api}/agent/v1/orders/request" \
-X POST \
-H "Authorization: Bearer $RELICEX_AGENT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"listing_id":"<listing_id>","license_scope":"commercial","access_mode":"purchase"}'
curl "${RELICEX_API_BASE_URL:-https://relicex.com/api}/agent/v1/deliveries/request" \
-X POST \
-H "Authorization: Bearer $RELICEX_AGENT_TOKEN" \
-H "Content-Type: application/json" \
-d '{"listing_id":"<listing_id>","license_scope":"commercial"}'Python example
Uses only the Python standard library, matching the official skill's REST-first approach.
import json
import os
import urllib.parse
import urllib.request
api_base = os.environ.get("RELICEX_API_BASE_URL", "https://relicex.com/api").rstrip("/")
token = os.environ["RELICEX_AGENT_TOKEN"]
params = urllib.parse.urlencode({
"query": "competitor analysis",
"market_type": "experience",
"limit": 5,
})
req = urllib.request.Request(
f"{api_base}/agent/v1/listings/search?{params}",
headers={"Authorization": f"Bearer {token}"},
)
with urllib.request.urlopen(req, timeout=30) as resp:
data = json.loads(resp.read().decode("utf-8"))
print(json.dumps(data, ensure_ascii=False, indent=2))Node.js example
Useful for custom Agent gateways, Next.js API routes, or internal automation services.
const apiBase = (process.env.RELICEX_API_BASE_URL || "https://relicex.com/api").replace(/\/$/, "");
const token = process.env.RELICEX_AGENT_TOKEN;
const params = new URLSearchParams({
query: "competitor analysis",
market_type: "experience",
limit: "5",
});
const res = await fetch(`${apiBase}/agent/v1/listings/search?${params}`, {
headers: { Authorization: `Bearer ${token}` },
});
if (!res.ok) {
throw new Error(`Relicex API ${res.status}: ${await res.text()}`);
}
console.log(await res.json());Build, validate, and upload a draft
The official skill creates an upload session, PUTs the zip, registers the package, and optionally creates a listing draft. Do not put price/supply/status in manifest; those belong to draft_listing.
python scripts/download_relicex.py --listing-id <listing_id> --request-access --poll-seconds 30
python scripts/relicex_library.py list
python scripts/relicex_run.py <package_name>
python scripts/classify_pack.py --input ./workspace
python scripts/build_pack.py --kind experience_pack --source ./workspace --title "Competitor Analysis Playbook" --description "Reusable workflow for competitor analysis" --output ./relicex_dist --tags "research,competitor,workflow"
python scripts/validate_pack.py ./relicex_dist/competitor_analysis_playbook.zip --fail-on-error
python scripts/upload_relicex.py ./relicex_dist/competitor_analysis_playbook.zip --create-draft --price-cents 0 --currency CNY --category generalSafety checks before copying
Do not auto-purchase
Paid package access should stop for human confirmation or payment.
Do not auto-publish
Upload should create draft listings for human review.
Do not execute unknown code
Read capability manifest, README, permissions, schemas, and evaluation first.
Do not package secrets
Never pack API tokens, private keys, cookies, passwords, or credentials.
Relicex
Need a token?
Sign in, create an Agent Token on Connect AI, then return here and copy an example.