# Article Summarizer (Claude — TL;DR + Bullets + Topics) (`gochujang/article-summarizer`) Actor

Pass any URL or text — get back a tight summary in your chosen style (TL;DR / bullets / executive / tweet) plus topic tags + sentiment. Article body auto-extracted via trafilatura. BYO Anthropic API key. $0.005 per summary, Claude tokens billed by Anthropic.

- **URL**: https://apify.com/gochujang/article-summarizer.md
- **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community)
- **Categories:** Developer tools, Automation, Other
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Article Summarizer (Claude)

> Pass any URL or text — get back a tight summary in your chosen style (**TL;DR / bullets / executive / tweet**) plus topic tags + sentiment. Article body auto-extracted via trafilatura. **BYO Anthropic API key. $0.005 per summary.**

---

### Why this exists

Summarizing 50 articles a day by hand is dead time. Hiring a summarization SaaS (e.g. Lex.page, Glasp, Summari) costs $20-100/month per seat. This actor wraps trafilatura (article extraction) + Claude (summarization) in one call:

1. URL → clean article body (no nav, ads, comments)
2. Body → Claude with your chosen output style
3. Optional: topic tags + sentiment

You pay Apify $0.005 per summary; Anthropic bills you for tokens (typically $0.001-0.01 per summary at Opus 4.7 prices).

---

### What you get

```json
{
  "url": "https://...",
  "title": "Bitcoin tops $70K",
  "author": "Jane Doe",
  "date_published": "2026-06-09",
  "sitename": "TechCrunch",
  "char_count_input": 4820,
  "summary": "**TL;DR**: BTC ...\n\n- Key 1\n- Key 2\n- Key 3\n...",
  "style": "both",
  "model": "claude-opus-4-7",
  "language": "en",
  "claude_usage": {"input_tokens": 2580, "output_tokens": 360}
}
````

***

### Output styles

| `style` | What you get |
|---|---|
| `tldr` | Single paragraph TL;DR |
| `bullets` | 5–7 key bullet points |
| `both` | TL;DR + bullets (default) |
| `twitter` | 280-char tweet of the most surprising idea |
| `executive` | TL;DR + key implications + recommended action |

***

### Quick start

#### Summarize a URL

```json
{
  "url": "https://en.wikipedia.org/wiki/Bitcoin",
  "style": "both",
  "anthropicApiKey": "sk-ant-..."
}
```

#### Summarize pasted text

```json
{
  "text": "Long article text here...",
  "style": "tldr",
  "maxWords": 100,
  "anthropicApiKey": "sk-ant-..."
}
```

#### Executive briefing in Korean

```json
{
  "url": "https://...",
  "style": "executive",
  "language": "ko",
  "anthropicApiKey": "sk-ant-..."
}
```

***

### Setting your Anthropic API key

You can:

1. **Paste in input** — secure (marked `isSecret`, encrypted at rest, hidden in logs)
2. **Save as Apify Task** — input including key is saved, click to re-run
3. **Account-level Secret** — register `MY_ANTHROPIC_KEY` in Apify Integrations, reference as `@MY_ANTHROPIC_KEY` in task input

Get a key at [console.anthropic.com](https://console.anthropic.com).

***

### Pricing

**Pay-Per-Event**: `$0.005 per article` (Apify-side).

Anthropic charges separately for tokens. Typical totals:

| Article length | Input tokens | Anthropic cost (Opus 4.7) | Total |
|---|---|---|---|
| 1K words | ~1300 | ~$0.007 | $0.012 |
| 3K words | ~4000 | ~$0.020 | $0.025 |
| 8K words | ~10500 | ~$0.053 | $0.058 |

Use Sonnet (~5x cheaper) or Haiku (~10x cheaper) for cost savings.

***

### Use cases

1. **Newsletter automation** — Daily Top-50 feed → bullet summaries
2. **Research aggregation** — Build a topic-tagged knowledge base
3. **Slack/Discord digests** — Daily summary of #blog-feed channel
4. **Personal read-it-later** — Long articles → 30-second TL;DR
5. **SEO content audit** — Compare summaries of competitor posts

***

### Related actors (same author)

- [Web Page → Markdown Converter](https://apify.com/gochujang/web-to-markdown) — Same extraction without LLM
- [Web Structured Data Extractor](https://apify.com/gochujang/web-structured-extractor) — Extract JSON, not summary
- [Tweet Thread → Article](https://apify.com/gochujang/tweet-thread-to-article)
- [HTML Metadata Extractor](https://apify.com/gochujang/html-metadata-extractor)

***

### Feedback

A short review helps content engineers find it: [Leave a review on Apify Store](https://apify.com/gochujang/article-summarizer#reviews)

# Actor input Schema

## `url` (type: `string`):

URL of the article (used if 'text' is empty).

## `text` (type: `string`):

Pass article text directly to skip URL fetch.

## `style` (type: `string`):

Output format.

## `maxWords` (type: `integer`):

Soft cap on summary length.

## `language` (type: `string`):

ISO code or language name (e.g. en, ko, es, French).

## `extractTopics` (type: `boolean`):

Append a JSON block with 3-5 topic tags + sentiment.

## `model` (type: `string`):

Claude model to use. Opus is highest-quality; Haiku is fastest/cheapest.

## `anthropicApiKey` (type: `string`):

Get one at console.anthropic.com. Saved encrypted by Apify.

## `userAgent` (type: `string`):

Custom UA.

## Actor input object example

```json
{
  "url": "",
  "text": "",
  "style": "both",
  "maxWords": 250,
  "language": "en",
  "extractTopics": true,
  "model": "claude-opus-4-7",
  "userAgent": ""
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("gochujang/article-summarizer").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("gochujang/article-summarizer").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call gochujang/article-summarizer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=gochujang/article-summarizer",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Article Summarizer (Claude — TL;DR + Bullets + Topics)",
        "description": "Pass any URL or text — get back a tight summary in your chosen style (TL;DR / bullets / executive / tweet) plus topic tags + sentiment. Article body auto-extracted via trafilatura. BYO Anthropic API key. $0.005 per summary, Claude tokens billed by Anthropic.",
        "version": "0.1",
        "x-build-id": "M9nYWYrO2VHsBtLwB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/gochujang~article-summarizer/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-gochujang-article-summarizer",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/gochujang~article-summarizer/runs": {
            "post": {
                "operationId": "runs-sync-gochujang-article-summarizer",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/gochujang~article-summarizer/run-sync": {
            "post": {
                "operationId": "run-sync-gochujang-article-summarizer",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "anthropicApiKey"
                ],
                "properties": {
                    "url": {
                        "title": "Article URL",
                        "type": "string",
                        "description": "URL of the article (used if 'text' is empty).",
                        "default": ""
                    },
                    "text": {
                        "title": "Raw text (skip URL fetch)",
                        "type": "string",
                        "description": "Pass article text directly to skip URL fetch.",
                        "default": ""
                    },
                    "style": {
                        "title": "Summary style",
                        "enum": [
                            "tldr",
                            "bullets",
                            "both",
                            "twitter",
                            "executive"
                        ],
                        "type": "string",
                        "description": "Output format.",
                        "default": "both"
                    },
                    "maxWords": {
                        "title": "Max words",
                        "minimum": 30,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Soft cap on summary length.",
                        "default": 250
                    },
                    "language": {
                        "title": "Output language",
                        "type": "string",
                        "description": "ISO code or language name (e.g. en, ko, es, French).",
                        "default": "en"
                    },
                    "extractTopics": {
                        "title": "Include topics + sentiment",
                        "type": "boolean",
                        "description": "Append a JSON block with 3-5 topic tags + sentiment.",
                        "default": true
                    },
                    "model": {
                        "title": "Claude model",
                        "enum": [
                            "claude-opus-4-7",
                            "claude-sonnet-4-6",
                            "claude-haiku-4-5"
                        ],
                        "type": "string",
                        "description": "Claude model to use. Opus is highest-quality; Haiku is fastest/cheapest.",
                        "default": "claude-opus-4-7"
                    },
                    "anthropicApiKey": {
                        "title": "Anthropic API Key",
                        "type": "string",
                        "description": "Get one at console.anthropic.com. Saved encrypted by Apify."
                    },
                    "userAgent": {
                        "title": "User-Agent (for URL fetch)",
                        "type": "string",
                        "description": "Custom UA.",
                        "default": ""
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
