# agent402.tools Link Preview Card Generator

> agent402.tools Link Preview Card Generator is a paid API for AI agents from agent402.tools, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Fetches a URL and returns a normalized link preview card with OpenGraph/Twitter metadata, article description fallback, and standardized 1200×630 image

## Facts

- Endpoint: POST https://agent402.tools/api/skill/link-preview
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-link-preview-card-generator-9eb6ab6c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eH15p-KXJdTPxlfWPG2eq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-tools-link-preview-card-generator-9eb6ab6c -d '<json body>'
```

Example prompt: Can you build me a link preview card for https://techcrunch.com/2024/05/15/openai-announces-new-model/ — I need the title, description, and a normalized 1200×630 preview image pulled from its OpenGraph and Twitter card metadata?

## When to prefer this

Use this endpoint when you need a fully normalized, card-ready link preview (title, description, standardized 1200×630 image) from a single public URL, especially when you want automatic fallback from OpenGraph to article body content and image normalization built in — rather than writing custom scraping logic or calling multiple metadata APIs separately.

## Known failure modes

- URL is not publicly accessible or returns a non-200 status — preview card cannot be generated
- Target page has no OpenGraph or Twitter card tags and no extractable article body — description will be empty
- og:image cannot be fetched or normalized — image field may be missing or null
- Malformed or non-HTTP(S) URL provided — validation error returned
- Target site blocks scrapers or returns CAPTCHA — metadata extraction fails

## How this service works

Bundled execution of the Link preview card workflow - The 'turn a URL into a card-shaped preview' workflow. Pull OpenGraph/Twitter card metadata, fetch the article body as a description fallback, normalize the og:image into a standard 1200×630 social card variant and a 400×400 square thumbnail, and extract URL/mention entities from the body for related-link surfacing. Five tools, one structured card payload ready for chat embeds, social shares, or RSS-to-card pipelines.

## Output

A structured link preview card object containing the page title, description (from og:description or article body fallback), normalized og:image at 1200×630 resolution, and other OpenGraph/Twitter card metadata extracted from the target URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Public http(s) URL to build a preview card for (e.g. https://example.com/article)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "args": {
   "url": "https://example.com"
  },
  "pack": "link-preview",
  "steps": [
   {
    "ok": true,
    "slug": "meta",
    "result": {}
   },
   {
    "ok": true,
    "slug": "extract",
    "result": {}
   },
   {
    "ok": true,
    "slug": "image-resize",
    "result": {}
   },
   {
    "ok": true,
    "slug": "image-thumbnail",
    "result": {}
   },
   {
    "ok": true,
    "slug": "extract-entities",
    "result": {}
   }
  ],
  "summary": "5/5 steps succeeded"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-link-preview-card-generator-9eb6ab6c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)
