# Czech Name Vocative & Greeting Generator (oslovení, 5. pád) (`soaring_fad_p9q/czech-name-greetings`) Actor

Turn Czech names into correct greetings: vocative (5. pád), gender, formal and informal salutations, academic titles. For cold emails, newsletters and CRM.

- **URL**: https://apify.com/soaring_fad_p9q/czech-name-greetings.md
- **Developed by:** [Marek](https://apify.com/soaring_fad_p9q) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 abcs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Czech Name Vocative & Greeting Generator (oslovení, 5. pád)

Czech uses the vocative case (*5. pád*) when addressing people. "Dobrý den, pane Novák" is wrong, "Dobrý den, pane Nováku" is right. Doing this by hand for a contact list is slow, and AI chatbots are not consistent. This actor returns the correct vocative form for every name you provide.

### What you get

For each input name, the actor outputs:

| Field | Example (for "Ing. Petr Novák") |
|-------|----------------------------------|
| `titles` | "Ing." |
| `firstNameVocative` | "Petře" |
| `lastNameVocative` | "Nováku" |
| `gender` | "male" |
| `greetingFormal` | "Vážený pane Nováku" |
| `greetingNeutral` | "Dobrý den, pane Nováku" |
| `greetingInformal` | "Ahoj Petře" |
| `greetingWithTitle` | "Vážený pane inženýre" |

### Who it is for

- Cold email and outreach to Czech prospects
- Newsletters (Klaviyo, Mailchimp, Brevo)
- CRM clean-up (Clay, Make, Zapier, n8n)
- AI agents that write Czech emails

### Input

```json
{
    "names": ["Ing. Petr Novák", "Jana Nováková", "MUDr. Lucie Svobodová, Ph.D."],
    "lastNameFirst": false
}
```

**`names`** — Array of name strings. One per line if using the web UI, or as an array in JSON. Each entry is processed individually.

**`lastNameFirst`** — Boolean. If `true`, treat the first part of each name as the surname (e.g., "Novák Petr" instead of "Petr Novák"). Default: `false`.

### Output example

For input `"Ing. Petr Novák"`:

```json
{
    "input": "Ing. Petr Novák",
    "titles": "Ing.",
    "firstName": "Petr",
    "lastName": "Novák",
    "gender": "male",
    "firstNameVocative": "Petře",
    "lastNameVocative": "Nováku",
    "greetingFormal": "Vážený pane Nováku",
    "greetingNeutral": "Dobrý den, pane Nováku",
    "greetingInformal": "Ahoj Petře",
    "greetingWithTitle": "Vážený pane inženýre"
}
```

### Pricing

$1 per 1,000 names. Empty lines are skipped and not charged.

### How to use it

- Web UI: paste names one per line, click Start, download CSV/Excel/JSON or send to Google Sheets
- Apify API: call the actor via API
- Automation tools: trigger the actor from Make or Zapier

### Limits

- Names must be in nominative (1. pád)
- Foreign names are declined by Czech rules (e.g., John → Johne)
- Ambiguous names get the most common Czech gender

### Česky

Pomocník pro správné oslovení v češtině pomocí vokativu (5. pád) a skloňování jmen. Pomáhá při psaní e-mailů, mailing list nebo při úpravách dat v CRM. Správné oslovení je důležité pro profesionální dojem.

### Credits

- Library [vokativ](https://github.com/Mimino666/vokativ) by Michal Danilák, MIT license.

# Actor input Schema

## `names` (type: `array`):

One name per line, as written in your list, e.g. "Ing. Petr Novák" or "Jana Nováková". Academic titles are detected automatically.

## `lastNameFirst` (type: `boolean`):

Turn on if your list looks like "Novák Petr" instead of "Petr Novák".

## Actor input object example

```json
{
  "names": [
    "Ing. Petr Novák",
    "Jana Nováková",
    "MUDr. Lucie Svobodová, Ph.D.",
    "Tomáš Dvořák",
    "Jiří"
  ],
  "lastNameFirst": false
}
```

# Actor output Schema

## `results` (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 = {
    "names": [
        "Ing. Petr Novák",
        "Jana Nováková",
        "MUDr. Lucie Svobodová, Ph.D.",
        "Tomáš Dvořák",
        "Jiří"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("soaring_fad_p9q/czech-name-greetings").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 = { "names": [
        "Ing. Petr Novák",
        "Jana Nováková",
        "MUDr. Lucie Svobodová, Ph.D.",
        "Tomáš Dvořák",
        "Jiří",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("soaring_fad_p9q/czech-name-greetings").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "names": [
    "Ing. Petr Novák",
    "Jana Nováková",
    "MUDr. Lucie Svobodová, Ph.D.",
    "Tomáš Dvořák",
    "Jiří"
  ]
}' |
apify call soaring_fad_p9q/czech-name-greetings --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,soaring_fad_p9q/czech-name-greetings"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/r9h9qhGrshWIwBauP/builds/OCDAhz8bmpMQZNxNI/openapi.json