playbooks

home / skills / z980944038-dev / openclawwdl / atxp-1.0.0

atxp-1.0.0 skill

/skills/atxp-1.0.0

This skill lets you access ATXP paid API tools for real-time web search and AI-generated media (images, music, video) with authentication.

npx playbooks add skill z980944038-dev/openclawwdl --skill atxp-1.0.0

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
1.5 KB
---
name: atxp
description: Access ATXP paid API tools for web search, AI image generation, music creation, video generation, and X/Twitter search. Use when users need real-time web search, AI-generated media (images, music, video), or X/Twitter search. Requires authentication via `npx atxp login`.
---

# ATXP Tools

Access ATXP's paid API tools via CLI.

## Authentication

```bash
# Check if authenticated
echo $ATXP_CONNECTION

# If not set, login:
npx atxp login
source ~/.atxp/config
```

## Commands

| Command | Description |
|---------|-------------|
| `npx atxp search <query>` | Real-time web search |
| `npx atxp image <prompt>` | AI image generation |
| `npx atxp music <prompt>` | AI music generation |
| `npx atxp video <prompt>` | AI video generation |
| `npx atxp x <query>` | X/Twitter search |

## Usage

1. Verify `$ATXP_CONNECTION` is set
2. Run the appropriate command
3. Parse and present results

## Programmatic Access

```typescript
import { atxpClient, ATXPAccount } from '@atxp/client';

const client = await atxpClient({
  mcpServer: 'https://search.mcp.atxp.ai',
  account: new ATXPAccount(process.env.ATXP_CONNECTION),
});

const result = await client.callTool({
  name: 'search_search',
  arguments: { query: 'your query' },
});
```

## MCP Servers

| Server | Tool |
|--------|------|
| `search.mcp.atxp.ai` | `search_search` |
| `image.mcp.atxp.ai` | `image_create_image` |
| `music.mcp.atxp.ai` | `music_create` |
| `video.mcp.atxp.ai` | `create_video` |
| `x-live-search.mcp.atxp.ai` | `x_live_search` |

Overview

This skill provides CLI and programmatic access to ATXP's paid API tools for real-time web search, AI image generation, music creation, video generation, and X/Twitter (X) search. It requires authentication via npx atxp login and exposes both simple commands and a JavaScript client for integration. Use it to get fresh web results or generate media assets from prompts quickly.

How this skill works

The skill uses a local environment variable ATXP_CONNECTION for authentication; run npx atxp login to create and source the credential. From the CLI you run targeted commands (search, image, music, video, x) that call ATXP MCP servers. Programmatic access is available through the @atxp/client package, where you instantiate atxpClient with the appropriate MCP server and account token and call tools by name with arguments.

When to use it

  • When you need real-time web search results beyond static knowledge cutoffs.
  • When you want quick AI-generated images from textual prompts via the CLI.
  • When you need AI-generated music or video drafts for prototyping.
  • When you want to search X/Twitter content programmatically or from the terminal.
  • When integrating ATXP tools into a Node.js workflow or automation pipeline.

Best practices

  • Always verify ATXP_CONNECTION is set (echo $ATXP_CONNECTION) before running commands.
  • Run npx atxp login and source ~/.atxp/config in your shell so credentials persist.
  • Choose the correct MCP server for the tool (search, image, music, video, x).
  • Keep prompts concise and focused; include style, mood, and constraints for media generation.
  • Handle API responses defensively: check for errors, rate limits, and partial results.

Example use cases

  • Quickly pull live search results for news or trend monitoring with npx atxp search "topic".
  • Generate concept art or social media images with npx atxp image "prompt describing scene".
  • Produce background music drafts for videos using npx atxp music "mood, instruments, duration".
  • Create short video prototypes from prompts via npx atxp video "storyboard-like prompt".
  • Search recent X/Twitter posts for a keyword or hashtag using npx atxp x "query".

FAQ

How do I authenticate to use the tools?

Run npx atxp login and then source ~/.atxp/config or ensure ATXP_CONNECTION is set in your environment.

Can I call ATXP tools from code?

Yes. Install @atxp/client, create an ATXPAccount with your ATXP_CONNECTION token, instantiate atxpClient with the correct MCP server, and call client.callTool with the tool name and arguments.