ip-lookup

Query the public MyIPChecker IP information API and explain or return the geolocation and network fields it provides. Use when Codex needs to look up metadat...

Security Scan

The skill is internally consistent: it only documents and runs a simple curl-based helper to query the public MyIPChecker API and does not request unrelated credentials, installs, or privileged access.

Purpose & Capability

Name/description, SKILL.md, reference doc, and the shell helper all align: the skill's sole purpose is to call https://myipchecker.ai/api/ip (optionally with ?ip=) and summarize the returned geolocation/network fields. No unrelated resources or credentials are requested.

Instruction Scope

Runtime instructions are specific and scoped: read the included reference, prefer a live call via the provided sh script, treat non-200/empty/invalid JSON as API failures, and summarize returned fields. The instructions do not ask the agent to read local secrets or other system files.

Install Mechanism

No install spec; the skill is instruction-only with a small shell script. The script only uses standard tools (curl, mktemp, sed) and writes only temporary files. No external archives or downloads are performed.

Credentials

The skill requires no environment variables, no credentials, and no config paths. This is proportionate for a read-only public-IP lookup service.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system configs, and does not require persistent presence or elevated privileges.

Assessment

This skill will make outbound HTTP requests to the public service https://myipchecker.ai and will send any IP you ask about (and the agent's caller IP if you omit --ip). Only use it with IPs you are comfortable transmitting to a third-party API. The helper script requires curl to be available; it uses temporary files and a browser-like User-Agent to avoid Cloudflare blocks. There are no requested secrets or installs, but be aware that live lookups inherently disclose the queried IP to the remote service and that you can override the base URL with --base-url if you want to test a different endpoint.

MyIPChecker IP Info

Treat the deployed MyIPChecker IP information endpoint as the only source of truth for this skill.

Read references/myipchecker-api.md before describing parameters, response fields, or observed failure behavior.

Use scripts/get_myipchecker_ip_info.sh for live requests. The script is a pure shell helper that uses curl and already sends a browser-style User-Agent, because the deployed site blocks simple non-browser request signatures.

Do not describe this API as the repo's local ping route. The public endpoint currently returns IP metadata such as country, city, coordinates, timezone, ISP, and AS information.

Workflow

1. Decide whether the user wants a live lookup, the caller IP info, an explanation of response fields, or troubleshooting for a failed request.
2. Read references/myipchecker-api.md for the current contract and observed edge cases.
3. Prefer a real request through scripts/get_myipchecker_ip_info.sh.
4. Pass --ip <ipv4> when the user gives a target IP.
5. Omit --ip when the user wants the caller IP information from the deployed service.
6. Treat non-200 responses, empty bodies, or invalid JSON as upstream/API failures rather than successful lookups.
7. Summarize the returned fields in plain language unless the user explicitly asks for raw JSON.

Request Rules

• Use ip as the only supported lookup parameter.
• Do not rely on target; observed requests with target fall back to caller-IP behavior.
• Use a browser-style User-Agent for live calls.
• Expect JSON on success.
• Handle empty error bodies gracefully.

Response Rules

• Successful responses are plain JSON objects, not the repo's code/message/data wrapper.
• Common fields include ip, country, countryCode, region, city, zip, lat, lon, timezone, isp, org, and as.
• Some fields may be absent depending on the looked-up IP.
• For invalid or unsupported inputs, the deployed API may return an HTTP error with no JSON body.

Examples

• Input: Look up 8.8.8.8 in MyIPChecker Output: Run sh skill/myipchecker-ip-info/scripts/get_myipchecker_ip_info.sh --ip 8.8.8.8, then summarize the country, city, coordinates, timezone, and network owner.

• Input: What does the deployed IP info endpoint return with no parameters? Output: Explain that the deployed endpoint returns metadata for the caller IP when ip is omitted, then use the helper script without --ip if a live call is required.

• Input: Why did my lookup fail with a 500 response? Output: Explain that the upstream API can fail before returning a successful lookup payload, and that the error body may be empty or may contain a separate error JSON object.

Live Call Commands

sh skill/myipchecker-ip-info/scripts/get_myipchecker_ip_info.sh
sh skill/myipchecker-ip-info/scripts/get_myipchecker_ip_info.sh --ip 8.8.8.8
sh skill/myipchecker-ip-info/scripts/get_myipchecker_ip_info.sh --ip 1.1.1.1
sh skill/myipchecker-ip-info/scripts/get_myipchecker_ip_info.sh --base-url <service-base-url> --ip 103.224.172.246

If a live request fails with Cloudflare 1010 or another non-JSON response, say so plainly and include the HTTP status plus any response body that is available.