apify · jancurn · Aug 5, 2025 · Aug 5, 2025 · Aug 21, 2025 · Aug 22, 2025
@@ -122,7 +122,7 @@ info:
     ```
 
     However, there are a few explicitly described exceptions, such as
-    Dataset [Get items](#/reference/datasets/item-collection/get-items) or
+    [Get dataset items](#/reference/datasets/item-collection/get-items) or
     Key-value store [Get record](#/reference/key-value-stores/record/get-record)
     API endpoints, which return data in other formats.
     In case of an error, the response has the HTTP status code in the range of

@@ -153,7 +153,7 @@ post:
     To fetch the Actor run results that are typically stored in the default
     dataset, you'll need to pass the ID received in the `defaultDatasetId` field
     received in the response JSON to the
-    [Get items](#/reference/datasets/item-collection/get-items) API endpoint.
+    [Get dataset items](#/reference/datasets/item-collection/get-items) API endpoint.
   operationId: actorTask_runs_post
   parameters:
     - name: actorTaskId

@@ -145,7 +145,7 @@ post:
 
     To fetch the Actor run results that are typically stored in the default
     dataset, you'll need to pass the ID received in the `defaultDatasetId` field
-    received in the response JSON to the [Get items](#/reference/datasets/item-collection/get-items)
+    received in the response JSON to the [Get dataset items](#/reference/datasets/item-collection/get-items)
     API endpoint.
   operationId: act_runs_post
   parameters:

@@ -1,7 +1,7 @@
 get:
   tags:
     - Storage/Datasets
-  summary: Get items
+  summary: Get dataset items
   description: |
     Returns data stored in the dataset in a desired format.
 

@@ -254,7 +254,7 @@ The **run info** JSON also contains the IDs of the default [dataset](/platform/s
 
 > If you are scraping products, or any list of items with similar fields, the [dataset](/platform/storage/dataset) should be your storage of choice. Don't forget though, that dataset items are immutable. This means that you can only add to the dataset, and not change the content that is already inside it.
 
-To retrieve the data from a dataset, send a GET request to the [**Get items**](/api/v2/dataset-items-get) endpoint and pass the `defaultDatasetId` into the URL. For a GET request to the default dataset, no token is needed.
+To retrieve the data from a dataset, send a GET request to the [**Get dataset items**](/api/v2/dataset-items-get) endpoint and pass the `defaultDatasetId` into the URL. For a GET request to the default dataset, no token is needed.
 
 ```cURL
 https://api.apify.com/v2/datasets/DATASET_ID/items

@@ -10,7 +10,7 @@ hide_table_of_contents: true
 <!-- vale off -->
 <!-- markdownlint-disable -->
 
-## Company details (Impressum)
+## Legal info (Imprint)
 
 **Apify Technologies s.r.o.**<br/>
 Registered seat: Vodickova 704/36, 110 00 Prague 1, Czech Republic<br/>

@@ -2,7 +2,7 @@ module.exports = {
     legal: [
         {
             type: 'link',
-            label: 'Company details (Impressum)',
+            label: 'Legal info (Imprint)',
             href: '/legal',
         },
         {

@@ -1,19 +1,22 @@
 ---
-title: Build with AI
+title: Building new Actors with AI
 sidebar_position: 3
-description: Learn how to set up your environment, choose the right tools, and establish workflows for effective vibe coding
+sidebar_label: Build with AI
+description: Learn how to build new Actors or improving existing ones using AI code generation and vibe coding tools.
 slug: /actors/development/quick-start/build-with-ai
 toc_max_heading_level: 4
 ---
 
-**Set up your environment, choose tools, and build workflows for effective AI development.**
+**Learn how to develop new Actors or improve existing ones using AI code generation and vibe coding tools.**
 
 ---
 
 import { RULES_AND_INSTRUCTIONS_PROMPT } from "@site/src/utils/ai-prompts";
 import PromptButton from "@site/src/components/PromptButton";
 
-This guide explains how to enhance your development workflow by leveraging `llms.txt` and `llms-full.txt` with an AI assistant. You will learn how to provide foundational context and further refine AI's behavior with specific rules and instruction files.
+This guide provides best practices for building new Actors or improving existing ones using AI code generation
+and vibe coding tools such as Cursor, Claude Code, or Visual Studio Code,
+by providing the AI agents with the right instructions and context.
 
 ## `llms.txt` and `llms-full.txt`
 

@@ -1,5 +1,6 @@
 ---
-title: Quick start
+title: Actor development quick start
+sidebar_label: Quick start
 sidebar_position: 1
 description: Create your first Actor using the Apify Web IDE or locally in your IDE.
 slug: /actors/development/quick-start

@@ -1,5 +1,6 @@
 ---
-title: Local development
+title: Local Actor development
+sidebar_label: Local development
 sidebar_position: 1
 description: Create your first Actor locally on your machine, deploy it to the Apify platform, and run it in the cloud.
 slug: /actors/development/quick-start/locally

@@ -118,4 +118,4 @@ print(dataset_items)
 
 The newly started Actor runs under the account associated with the provided `token`, and therefore all resources consumed are charged to this user account.
 
-Internally, the `call()` function invokes the [Run Actor](/api/v2/#/reference/actors/run-collection/run-actor) API endpoint, waits for the Actor to finish, and reads its output using the [Get items](/api/v2/#/reference/datasets/item-collection/get-items) API endpoint.
+Internally, the `call()` function invokes the [Run Actor](/api/v2/#/reference/actors/run-collection/run-actor) API endpoint, waits for the Actor to finish, and reads its output using the [Get dataset items](/api/v2/#/reference/datasets/item-collection/get-items) API endpoint.
@@ -10,9 +10,10 @@ import Card from "@site/src/components/Card";
 import CardGrid from "@site/src/components/CardGrid";
 import homepageContent from "./homepage_content.json";
 
-> **Apify** is a cloud platform that helps you build reliable web scrapers, fast, and automate anything you can do manually in a web browser.
+
+> **Apify** is a cloud platform and marketplace of tools for web data extraction and automation.
 >
-> **Actors** are serverless cloud programs running on the Apify platform that can easily crawl websites with millions of pages, but also perform arbitrary computing jobs such as sending emails or data transformations. They can be started manually, using our API or scheduler, and they can be easily integrated with other apps.
+> **Actors** are serverless programs that run in the cloud. They can perform anything from simple actions such as filling out a web form or sending an email, to complex operations such as crawling a website with a million pages, or removing duplicates from a large dataset. Actors can persist their state and be restarted, and thus they can run as short or as long as necessary, from seconds to hours, even infinitely.
 
 ## Getting started
 

@@ -8,7 +8,8 @@ slug: /integrations/mcp
 
 <!-- markdownlint-disable MD024 -->
 
-The _Apify Model Context Protocol (MCP) Server_ allows AI applications to connect to Apify's extensive library of Actors as tools to perform web scraping, data extraction, or other automation tasks in real time.
+The Apify [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server allows AI applications and agents to search and run Actors from [Apify Store](https://apify.com/store) as tools for web scraping, data extraction, or automation,
+as well as access Apify documentation and tutorials from your AI coding environments.
 
 ![Apify MCP Server](../../images/apify_mcp_server.png)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -118,4 +118,4 @@ print(dataset_items)

		The newly started Actor runs under the account associated with the provided `token`, and therefore all resources consumed are charged to this user account.

		Internally, the `call()` function invokes the [Run Actor](/api/v2/#/reference/actors/run-collection/run-actor) API endpoint, waits for the Actor to finish, and reads its output using the [Get items](/api/v2/#/reference/datasets/item-collection/get-items) API endpoint.
		Internally, the `call()` function invokes the [Run Actor](/api/v2/#/reference/actors/run-collection/run-actor) API endpoint, waits for the Actor to finish, and reads its output using the [Get dataset items](/api/v2/#/reference/datasets/item-collection/get-items) API endpoint.