← Back to Skills Marketplace
theill

API KISS

by Peter Theill · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
125
Downloads
2
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install apikiss
Description
Access weather, IP geolocation, SMS, email, crypto prices, QR codes, Danish CVR, Whois, phone lookup, UUID, stock data, passwords, and more via the API KISS...
README (SKILL.md)

API KISS

Use the API KISS unified gateway to call dozens of services through one consistent API with Bearer token auth.

API KISS queries multiple upstream providers in parallel for read operations (returning the fastest response) and uses smart fallback for write operations (trying alternative providers on failure).

Setup

Set your API key as an environment variable:

APIKISS_API_KEY=your_token_here

All requests use:

  • Base URL: https://www.apikiss.com/api/v1/
  • Auth header: Authorization: Bearer $APIKISS_API_KEY
  • Method: GET for all endpoints (parameters are query strings)

Available Endpoints

Endpoint Description Required Params
/weather Current weather by coordinates latitude, longitude
/ip Your IP address (none)
/sms Send SMS worldwide phone, message
/flash-sms Send flash SMS (appears on screen instantly) to, message
/email Send email (HTML or plain text) to, subject, + body or html
/crypto Real-time cryptocurrency price in USD symbol
/cvr Danish Business Registry lookup query
/whois Domain registration info domain
/phone-lookup Validate phone number, carrier, type, country phone
/uuid Generate a UUID v4 (free) (none)
/stock Real-time stock quote symbol
/time Current time at coordinates latitude, longitude
/password Generate a secure password length (optional)
/password/validate Check password strength (score 0-4) password (JSON body)
/photo Get a random photo URL (none)
/qr-code Generate QR code (binary PNG/SVG) (free) data
/qr-code/generate Generate QR code (JSON with base64 image) (free) data
/chuck-norris-facts Random Chuck Norris fact (free) (none)

Endpoint Details

Weather — GET /weather

Returns current conditions: temperature (Celsius + Kelvin), humidity, pressure, visibility, and summary.

Param Type Required Description
latitude number yes Latitude of the location
longitude number yes Longitude of the location

IP — GET /ip

Returns your current IP address. No parameters needed.

SMS — GET /sms

Sends an SMS message. Returns { "success": true }.

Param Type Required Description
phone string yes Recipient phone number (e.g. +4512345678)
message string yes Message text

Flash SMS — GET /flash-sms

Sends a flash SMS that appears directly on the recipient's screen. Returns message_id and status.

Param Type Required Description
to string yes Recipient phone number
message string yes Message text

Email — GET /email

Sends an email via providers like Resend. Returns success, provider, and message_id.

Param Type Required Description
to string yes Recipient email address
subject string yes Email subject line
body string conditional Plain text body (required if html not provided)
html string conditional HTML body (required if body not provided)
from string no Sender address (defaults to [email protected])

Crypto — GET /crypto

Returns the current price in USD, averaged from multiple exchanges.

Param Type Required Description
symbol string yes Cryptocurrency symbol (e.g. BTC, ETH)

CVR — GET /cvr

Danish Business Registry. Returns company name, CVR number, address, phone, email, country.

Param Type Required Description
query string yes Company name or CVR number

Whois — GET /whois

Domain registration details (registrar, dates, nameservers).

Param Type Required Description
domain string yes Domain name (e.g. example.com)

Phone Lookup — GET /phone-lookup

Validates a phone number. Returns validity, country, carrier, and line type.

Param Type Required Description
phone string yes Phone number to look up

UUID — GET /uuid

Generates a cryptographically secure UUID v4. No parameters. Free tier.

Stock — GET /stock

Returns the current stock price.

Param Type Required Description
symbol string yes Stock ticker symbol (e.g. AAPL)

Time — GET /time

Returns the current time at the given coordinates as an ISO 8601 timestamp.

Param Type Required Description
latitude number yes Latitude
longitude number yes Longitude

Password — GET /password

Generates a secure random password.

Param Type Required Description
length integer no Desired password length

Password Validate — GET /password/validate

Checks password strength. Returns a score (0–4) and feedback with suggestions. Send a JSON body: { "password": "MySecurePassword123!" }

Photo — GET /photo

Returns a random photo URL. No parameters.

QR Code (binary) — GET /qr-code

Returns a raw PNG or SVG image file directly.

Param Type Required Description
data string yes Text/URL to encode
size integer no Size in pixels (32–1024)
output_format string no png or svg
error_correction string no l, m, q, or h
foreground string no Hex color (e.g. #ff0000)
background string no Hex color (e.g. #ffffff)

QR Code (JSON) — GET /qr-code/generate

Returns JSON with base64-encoded image data. Same parameters as above.

Chuck Norris Facts — GET /chuck-norris-facts

Returns a random Chuck Norris fact. No parameters. Free tier.

Usage Examples

Weather

curl "https://www.apikiss.com/api/v1/weather?latitude=55.6761&longitude=12.5683" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

IP

curl "https://www.apikiss.com/api/v1/ip" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

Send SMS

curl "https://www.apikiss.com/api/v1/sms?phone=%2B4512345678&message=Hello+from+OpenClaw!" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

Send Email

curl "https://www.apikiss.com/api/v1/email?to=recipient%40example.com&subject=Hello&body=Hi+there" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

Crypto Price

curl "https://www.apikiss.com/api/v1/crypto?symbol=BTC" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

Danish CVR Lookup

curl "https://www.apikiss.com/api/v1/cvr?query=Novo+Nordisk" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

QR Code (save as PNG)

curl "https://www.apikiss.com/api/v1/qr-code?data=https%3A%2F%2Fexample.com&size=256" \
  -H "Authorization: Bearer $APIKISS_API_KEY" -o qr.png

Generate Password

curl "https://www.apikiss.com/api/v1/password?length=20" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

Stock Quote

curl "https://www.apikiss.com/api/v1/stock?symbol=AAPL" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

UUID

curl "https://www.apikiss.com/api/v1/uuid" \
  -H "Authorization: Bearer $APIKISS_API_KEY"

External Endpoints

All requests go to: https://www.apikiss.com/api/v1/*

Data sent includes only the query parameters you provide (e.g. coordinates, phone number, symbol). Your APIKISS_API_KEY is sent as a Bearer token in the Authorization header and never logged locally.

Security & Privacy

  • Your API key stays in your environment — never in prompts or logs.
  • Only the data you explicitly pass as parameters leaves your machine.
  • API KISS does not store request payloads.

Trust Statement

By using this skill, queries are sent to https://www.apikiss.com. Only install if you trust apikiss.com with the data you pass to it.

Usage Guidance
This skill appears to do what it says: it proxies many small services through one API key. Before installing: (1) Treat APIKISS_API_KEY as sensitive — it can send SMS/emails and perform lookups, and could incur costs or enable abuse if leaked. (2) Confirm provider pricing, rate limits, and acceptable-use policy. (3) Ask the maintainer/provider to clarify the GET vs JSON inconsistency (e.g., /password/validate) and whether message bodies are sent in query strings (which can be logged). (4) Prefer creating a scoped or low-privilege key if provider supports it, and rotate the key if you test with real data. (5) Avoid sending sensitive personal data through the skill unless you have reviewed the provider's privacy/security practices.
Capability Analysis
Type: OpenClaw Skill Name: apikiss Version: 1.0.1 The skill acts as a documentation-based wrapper for the apikiss.com unified API gateway, providing access to various utilities like weather, SMS, and crypto data. While the use of GET requests for state-changing operations (SMS/Email) and the password validation endpoint represent minor security design flaws (potential logging of sensitive parameters), there is no evidence of malicious intent, hidden instructions, or unauthorized data exfiltration in SKILL.md or _meta.json.
Capability Tags
cryptorequires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description promise (a single gateway to many small services) matches the declared requirement: one API key (APIKISS_API_KEY). No unrelated credentials, binaries, or install steps are requested.
Instruction Scope
SKILL.md confines actions to calling https://www.apikiss.com/api/v1/ endpoints with a Bearer token. however it states "Method: GET for all endpoints (parameters are query strings)" but later asks to send a JSON body for /password/validate — this is inconsistent. Many endpoints perform write actions (SMS, email) that will transmit user-provided content to an external service (expected for this skill but a privacy/abuse consideration). /ip returns the agent's public IP (expected) and query-string-based send endpoints may expose content in logs.
Install Mechanism
Instruction-only skill with no install spec, no code files, and no downloads — minimal installation risk (nothing is written to disk by the skill itself).
Credentials
Only APIKISS_API_KEY is required (appropriate), but that single credential grants broad capabilities (sending SMS/email, performing lookups, generating content) and may incur costs or be abused if leaked. The manifest doesn't request unrelated secrets.
Persistence & Privilege
Skill is not always-enabled and uses normal autonomous invocation. It does not request persistent system-level privileges or access to other skills' configurations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install apikiss
  3. After installation, invoke the skill by name or use /apikiss
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Major update: Expanded capabilities, new endpoints, and updated API usage. - Added email, QR code generation, password generation/validation, and random photo endpoints. - Significantly expanded endpoint documentation with required parameters, descriptions, and examples. - Updated base URL to `https://www.apikiss.com/api/v1/` and standardized all endpoints to use GET with query parameters. - Described API KISS's multi-provider, parallel/fallback strategy for reliability. - Added new features such as password scoring, QR code customization, and free-tier endpoints. - Improved security, usage, and trust statements.
v1.0.0
Initial release of the apikiss skill. - Unified access to weather, IP geolocation, SMS (including flash SMS), crypto prices, Danish CVR lookup, Whois, phone validation, UUID generation, stock data, time, password hashing/verification, image metadata, and random Chuck Norris facts. - Uses API KISS gateway with Bearer token authentication. - Simple environment variable setup for API key. - Includes example commands for all major endpoints. - Requests are performed securely; only user parameters are transmitted.
Metadata
Slug apikiss
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is API KISS?

Access weather, IP geolocation, SMS, email, crypto prices, QR codes, Danish CVR, Whois, phone lookup, UUID, stock data, passwords, and more via the API KISS... It is an AI Agent Skill for Claude Code / OpenClaw, with 125 downloads so far.

How do I install API KISS?

Run "/install apikiss" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is API KISS free?

Yes, API KISS is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does API KISS support?

API KISS is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created API KISS?

It is built and maintained by Peter Theill (@theill); the current version is v1.0.1.

💬 Comments