APIFreaks Platform Agent Skill

Getting Started

Quick Start

1. Install the skill.

npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform

2. Set your API key. Copy your key from your dashboard, or sign up free to get one with 10,000 free credits, no card needed. Save it as an environment variable so your agent can read it without the key ever entering the chat:

export APIFREAKS_API_KEY="your-api-key"

3. Ask your agent.

When does google.com expire, and who is its registrar?

Install Options

The Quick Start command installs the skill into the current project. To install it for a specific agent, use its command:

# Claude Code
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform -a claude-code

# Cursor
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform -a cursor

# Codex
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform -a codex

# GitHub Copilot
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform -a github-copilot

# Windsurf
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform -a windsurf

Add -g to any of these to install the skill for your user, so it works in every project:

# Global install
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platform -a claude-code -g

Installing by hand? Download the ZIP and unzip it into an apifreaks-platform folder inside your client's skills folder.

How Your Key Is Handled

• The agent looks for APIFREAKS_API_KEY first, then a config or .env file you point to, then a key you paste. If it finds none, it asks.
• It sends the key in the X-apiKey header rather than the URL.
• A pasted key is used for that session only. It isn't written to a file or repeated back to you.
• Organization and personal accounts have separate keys and separate balances.
• Using an MCP client? Put the key in the env block of your client config instead of an environment variable.

What It Does

The skill gives your agent rules, not a list of endpoints. At call time, the agent looks up the current path, version, parameters and credit cost, so it stays accurate as our catalog changes. One account, one API key and one credit balance cover every API.

What Your Agent Can Do

• Domains and DNS: WHOIS, availability, subdomains, reputation, typosquatting, DNS and SSL certificates
• IP and security: geolocation, threat, VPN and proxy detection
• Validation: email, phone, VAT, IBAN and SWIFT
• Location: geocoding, ZIP codes, countries and cities
• Web and documents: screenshots, web scraping, PDF processing and user agent parsing
• Enrichment at volume: lists of domains, IPs or emails, signup screening and server logs, including weather, astronomy, timezone, currency and commodity data

Use APIFreaks in Your AI Agent

How to Use

1. Describe your task in plain language. You don't need to name APIFreaks, an endpoint or a version. Your agent should pick up the skill whenever a task needs data it can't get on its own.
2. Review the cost of large jobs. For a list of domains, IPs or emails, the agent tells you the expected credit cost before it starts.
3. Get your results. Answers come back in the chat. Tables keep your input as the first column and mark rows with no result instead of dropping them. Screenshots and PDFs are saved as files.

For example, if you ask who owns example.com, the agent finds the WHOIS Domain Lookup API in llms-full.txt, reads its reference.md, makes the call and checks the credits it used. If the contact details are privacy-protected, it tells you so instead of reporting them as missing.

Try It

Once the skill is installed, try prompts like these:

# SSL
List the active subdomains of github.com and show when each SSL certificate expires.

# IP security
Is 185.220.101.1 a Tor exit node, VPN or proxy, and what is its threat score?

# Email validation
Is test@mailinator.com a valid, deliverable address, or a disposable one?

# VAT and IBAN
Validate VAT number NL803441526B01 and IBAN GB29NWBK60161331926819, and show the company name and the bank.

# Screenshots
Take a full-page screenshot of https://www.wikipedia.org in dark mode and save it as wikipedia.png.

How the Agent Works

• Access: if our MCP tools are installed, the agent uses them. Otherwise it calls the REST API directly.
• Discovery: it finds the endpoint and its credit cost in llms-full.txt, then reads that endpoint's reference.md for the version, parameters, response schema and errors.
• Results: it checks each response against the schema, not just the status code.
• Credits: only 2xx responses are billed. Check your balance with the Credits Usage API.
• Errors and limits: the agent passes on the error message as written and never retries a 401. On endpoints with concurrency limits, it starts one request at a time and slows down on a 429.

Troubleshooting

• The skill isn't found after install: run npx skills list to check it, then restart your client.
• The skill doesn't kick in: describe the task clearly, or mention APIFreaks.
• 401 errors: check that APIFREAKS_API_KEY holds a valid key.
• Calls are blocked: allow apifreaks.com and api.apifreaks.com in your client.

What's in the Skill

See Also

• APIFreaks MCP server: live API tools for any MCP client
• All agent skills
• Agents overview
• llms.txt: a machine-readable index of our APIs
• Skill source on GitHub