← Back to Skills Marketplace

mail-addr-creator

Name: mail-addr-creator
Author: jcwang502

by jcwang502 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ Security Clean

132

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install mail-addr-creator

Description

create one or many ordinary mailbox addresses in a cloudflare temporary mail system through the /admin/new_address admin api and return structured results. u...

README (SKILL.md)

Cloudflare Mail Address Creator

Use this skill to create ordinary mailbox addresses through https://mail-api.suilong.online/admin/new_address.

Workflow

Collect or infer name, domain, and enablePrefix.
Default enablePrefix to true when the user does not specify it.
If the user gives a full address such as [email protected], split it into name=t2 and domain=suilong.online.
Never hardcode real credentials in the skill. Read them from runtime environment variables or pass them as CLI flags.
Run python3 scripts/create_address.py for single or batch creation.
Return the script's JSON output directly unless the user asks for a reformatted summary.
Preserve the normalized statuses: created, already_exists, auth_error, error.
If local validation fails, fix the input before attempting the API call again.
Use --output-format csv and optionally --output-file \x3Cpath> when the user asks for exportable results.

Commands

Single address:

python3 scripts/create_address.py \
  --name t2 \
  --domain suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Single full address:

python3 scripts/create_address.py \
  --name [email protected] \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Batch addresses from a comma-separated list:

python3 scripts/create_address.py \
  --names alice,bob,charlie \
  --domain suilong.online \
  --enable-prefix true \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Batch addresses from a file:

python3 scripts/create_address.py \
  --names-file ./names.txt \
  --domain suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Export batch results as CSV:

python3 scripts/create_address.py \
  --names alice,bob,charlie \
  --domain suilong.online \
  --output-format csv \
  --output-file ./created-addresses.csv \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Runtime Environment

Prefer environment variables for secrets:

CLOUDFLARE_MAIL_ADMIN_AUTH
CLOUDFLARE_MAIL_BEARER_TOKEN
CLOUDFLARE_MAIL_FINGERPRINT
CLOUDFLARE_MAIL_LANG
CLOUDFLARE_MAIL_USER_TOKEN
CLOUDFLARE_MAIL_API_URL

Supporting Files

Read references/api.md for the endpoint contract and error mapping.
Read references/examples.md for example prompts and outputs.

OpenClaw Install Notes

Install this skill into an OpenClaw workspace under skills/cloudflare-mail-address-creator/, or globally under ~/.moltbot/skills/cloudflare-mail-address-creator/.

This package intentionally keeps only the OpenClaw-compatible skill files: SKILL.md, scripts/, and references/.

Usage Guidance

This package appears internally consistent: it runs the included Python script to POST to the documented admin endpoint and requires an admin auth token. Before installing, verify you trust the target API host (default: mail-api.suilong.online), review the included scripts yourself, and provide a dedicated, least-privilege admin credential (do not reuse unrelated keys). Note the registry metadata did not declare required env vars even though the SKILL.md and script expect them — make sure you supply the correct CLOUDFLARE_MAIL_ADMIN_AUTH (or pass it via CLI) and consider running the script in a sandboxed environment if you are unsure.

Capability Analysis

Type: OpenClaw Skill Name: mail-addr-creator Version: 1.0.0 The skill is a functional tool for managing temporary mailboxes via a third-party API (mail-api.suilong.online). The Python script (scripts/create_address.py) uses standard libraries to perform authenticated POST requests, handles credentials securely via environment variables, and includes robust input validation. No evidence of data exfiltration, malicious execution, or prompt injection was found; the code logic is transparent and aligns with the documentation provided in SKILL.md and README.md.

Capability Assessment

✓ Purpose & Capability

The name/description (create mailbox addresses via the admin API) matches the included script and references. The script posts to the documented backend endpoint and accepts admin credentials and optional tokens that are required to perform the stated operation.

✓ Instruction Scope

SKILL.md instructs the agent to run the shipped script and to supply or read admin credentials from the environment; the script only reads names (CLI, CSV/file), validates them, calls the API, and optionally writes CSV/JSON output. There are no instructions to read unrelated system files or send data to unexpected endpoints beyond the configurable API URL.

✓ Install Mechanism

There is no install spec; this is an instruction-only skill with a bundled Python script. No external downloads or package installs are performed by the skill, lowering installation risk. It expects a Python runtime to execute the script.

ℹ Credentials

The runtime needs sensitive admin credentials (CLOUDFLARE_MAIL_ADMIN_AUTH) and optionally bearer/user tokens — these are proportionate for calling an admin create-address API. Minor inconsistency: the registry metadata lists no required environment variables, while SKILL.md and the script explicitly rely on specific CLOUDFLARE_MAIL_* env vars; you should supply a dedicated, least-privilege admin credential for this task.

✓ Persistence & Privilege

always is false and the skill does not request persistent system privileges or modify other skills or global agent configs. It only runs the provided script when invoked.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install mail-addr-creator
After installation, invoke the skill by name or use /mail-addr-creator
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Initial release of Cloudflare Mail Address Creator skill. - Enables creation of one or many mailbox addresses via the Cloudflare temp mail system admin API. - Supports single and batch address creation, including from files and CSV export. - Accepts both full email addresses and separated name/domain inputs. - Utilizes environment variables for sensitive authentication information. - Provides clear status reporting for address creation outcomes. - Includes documentation for workflow, CLI usage, and OpenClaw installation.

Metadata

Slug mail-addr-creator

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is mail-addr-creator?

create one or many ordinary mailbox addresses in a cloudflare temporary mail system through the /admin/new_address admin api and return structured results. u... It is an AI Agent Skill for Claude Code / OpenClaw, with 132 downloads so far.

How do I install mail-addr-creator?

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

Is mail-addr-creator free?

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

Which platforms does mail-addr-creator support?

mail-addr-creator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created mail-addr-creator?

It is built and maintained by jcwang502 (@jcwang502); the current version is v1.0.0.

More Skills