lnget
An HTTP client that automatically handles L402 Lightning micropayments for accessing paid web content and APIs. It streamlines interaction with Lightning-monetized services.
About this skill
lnget is a powerful command-line HTTP client designed to interact seamlessly with web services requiring L402 Lightning micropayments. When it encounters an HTTP 402 Payment Required response with an L402 challenge, lnget automatically generates and pays the necessary Lightning invoice, then retries the original request. This automation simplifies access to paid APIs, premium content, and other Lightning-monetized resources without manual payment intervention. Agents can use lnget to programmatically fetch data from services that gate access behind micro-payments, making it ideal for tasks that involve interacting with a growing ecosystem of Lightning-integrated web services. It provides features like dry-run payments, JSON output for machine readability, token management, and introspection of its own CLI schema, ensuring robust and auditable operations. The utility is particularly valuable for AI agents that need to operate in a web environment where traditional subscription models are replaced by granular, per-request payments. By abstracting the payment process, lnget allows agents to focus on data retrieval and task completion, treating L402-protected resources much like any other accessible web endpoint.
Best use case
The primary use case for lnget is enabling AI agents or developers to programmatically access and consume web content, data, or API services that require small, on-demand payments via the Lightning Network (L402 protocol). It benefits anyone needing to integrate with or utilize services built on this micropayment model, automating the payment and retry logic to simplify development and operation.
An HTTP client that automatically handles L402 Lightning micropayments for accessing paid web content and APIs. It streamlines interaction with Lightning-monetized services.
A successful retrieval of the requested web resource (data, file, API response) after automatically handling any required L402 Lightning micropayments.
Practical example
Example input
lnget --json --params '{"url": "https://api.example.com/paid-data", "max_cost": 500}'Example output
{"status": "success", "url": "https://api.example.com/paid-data", "http_status": 200, "payment_info": {"amount_sat": 50, "preimage": "..."}, "body": "eyAid2VsY29tZSI6ICJ0byB0aGUgcGFpZCBzZXJ2aWNlIiB9"}When to use this skill
- When accessing API endpoints or web content protected by L402 Lightning payment challenges.
- To automate micropayments for web resources in an agent workflow.
- For previewing the cost of a Lightning payment before executing it with `--dry-run`.
- When you need machine-readable JSON output from an HTTP client, including response bodies and metadata.
When not to use this skill
- When accessing free web content or APIs that do not require any form of payment.
- If a traditional HTTP client (like curl or wget) is sufficient for the task.
- For managing or executing large, traditional financial transactions (it's designed for micro-payments).
- When the Lightning Network backend (`lnd` or `lnc`) is not available or configured.
How lnget Compares
| Feature / Agent | lnget | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | easy | N/A |
Frequently Asked Questions
What does this skill do?
An HTTP client that automatically handles L402 Lightning micropayments for accessing paid web content and APIs. It streamlines interaction with Lightning-monetized services.
How difficult is it to install?
The installation complexity is rated as easy. You can find the installation instructions above.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Top AI Agents for Productivity
See the top AI agent skills for productivity, workflow automation, operational systems, documentation, and everyday task execution.
AI Agent for YouTube Script Writing
Find AI agent skills for YouTube script writing, video research, content outlining, and repeatable channel production workflows.
SKILL.md Source
# lnget
Download files with automatic L402 Lightning micropayments. When a server
returns HTTP 402 Payment Required with an L402 challenge, lnget
automatically pays the Lightning invoice and retries the request.
## Quick Reference
```bash
# JSON metadata + inline response body
lnget --json --print-body https://api.example.com/data.json
# Pipe raw response body to stdout
lnget -q https://api.example.com/data.json | jq .
lnget -o - https://api.example.com/data.json
# Preview payment without executing
lnget --dry-run https://api.example.com/paid-endpoint
# Agent-first JSON input
lnget --json --params '{"url": "https://api.example.com/data", "max_cost": 500}'
# Introspect CLI schema
lnget schema --all
# Manage tokens
lnget tokens list --json --fields domain,amount_sat
# Check Lightning backend
lnget ln status --json
```
## Key Rules
1. Always use `--json` for machine-readable output
2. Use `--print-body` with `--json` to get response content inline
3. Use `--dry-run` before making payments
4. Use `-q` or `-o -` when you only want the raw response body
5. Use `--fields` to limit output to needed fields
6. Use `--force` on destructive commands (tokens clear)
7. Check `lnget schema <command>` for parameter details
## Full skill documentation
See `skills/lnget/SKILL.md` for comprehensive usage guide.Related Skills
workspace-surface-audit
Audit the active repo, MCP servers, plugins, connectors, env surfaces, and harness setup, then recommend the highest-value ECC-native skills, hooks, agents, and operator workflows. Use when the user wants help setting up Claude Code or understanding what capabilities are actually available in their environment.
ui-demo
Record polished UI demo videos using Playwright. Use when the user asks to create a demo, walkthrough, screen recording, or tutorial video of a web application. Produces WebM videos with visible cursor, natural pacing, and professional feel.
token-budget-advisor
Offers the user an informed choice about how much response depth to consume before answering. Use this skill when the user explicitly wants to control response length, depth, or token budget. TRIGGER when: "token budget", "token count", "token usage", "token limit", "response length", "answer depth", "short version", "brief answer", "detailed answer", "exhaustive answer", "respuesta corta vs larga", "cuántos tokens", "ahorrar tokens", "responde al 50%", "dame la versión corta", "quiero controlar cuánto usas", or clear variants where the user is explicitly asking to control answer size or depth. DO NOT TRIGGER when: user has already specified a level in the current session (maintain it), the request is clearly a one-word answer, or "token" refers to auth/session/payment tokens rather than response size.
skill-comply
Visualize whether skills, rules, and agent definitions are actually followed — auto-generates scenarios at 3 prompt strictness levels, runs agents, classifies behavioral sequences, and reports compliance rates with full tool call timelines
santa-method
Multi-agent adversarial verification with convergence loop. Two independent review agents must both pass before output ships.
safety-guard
Use this skill to prevent destructive operations when working on production systems or running agents autonomously.
repo-scan
Cross-stack source code asset audit — classifies every file, detects embedded third-party libraries, and delivers actionable four-level verdicts per module with interactive HTML reports.
project-flow-ops
Operate execution flow across GitHub and Linear by triaging issues and pull requests, linking active work, and keeping GitHub public-facing while Linear remains the internal execution layer. Use when the user wants backlog control, PR triage, or GitHub-to-Linear coordination.
product-lens
Use this skill to validate the "why" before building, run product diagnostics, and pressure-test product direction before the request becomes an implementation contract.
openclaw-persona-forge
为 OpenClaw AI Agent 锻造完整的龙虾灵魂方案。根据用户偏好或随机抽卡， 输出身份定位、灵魂描述(SOUL.md)、角色化底线规则、名字和头像生图提示词。 如当前环境提供已审核的生图 skill，可自动生成统一风格头像图片。 当用户需要创建、设计或定制 OpenClaw 龙虾灵魂时使用。 不适用于：微调已有 SOUL.md、非 OpenClaw 平台的角色设计、纯工具型无性格 Agent。 触发词：龙虾灵魂、虾魂、OpenClaw 灵魂、养虾灵魂、龙虾角色、龙虾定位、 龙虾剧本杀角色、龙虾游戏角色、龙虾 NPC、龙虾性格、龙虾背景故事、 lobster soul、lobster character、抽卡、随机龙虾、龙虾 SOUL、gacha。
manim-video
Build reusable Manim explainers for technical concepts, graphs, system diagrams, and product walkthroughs, then hand off to the wider ECC video stack if needed. Use when the user wants a clean animated explainer rather than a generic talking-head script.
laravel-plugin-discovery
Discover and evaluate Laravel packages via LaraPlugins.io MCP. Use when the user wants to find plugins, check package health, or assess Laravel/PHP compatibility.