# Sheffield Pottery Scraper (`parseforge/sheffield-pottery-scraper`) Actor

Scrapes Sheffield Pottery product pages and collections, returning each product as a flat row with title, price, stock, variants, images, and description.

- **URL**: https://apify.com/parseforge/sheffield-pottery-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $11.99 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Sheffield Pottery Scraper

**Scrape Sheffield Pottery products from any collection or product URL, up to a million per run.** Every product comes with its title, price, stock, variants, images, and description. No login or API key. Export to CSV, JSON, Excel, or XML.

Sheffield Pottery's catalog is public but spread across hundreds of collection pages, and there is no official API. This Actor reads the product pages directly, follows collection links, and returns each product as one flat row. You control which collections to scrape and how many products to collect.

| Who uses it | What they scrape Sheffield Pottery for |
|---|---|
| Ceramic supply shops | Monitor Sheffield Pottery's clay and glaze prices to stay competitive |
| Pottery studios | Build a searchable inventory of available clays, kilns, and tools |
| E-commerce analysts | Track product assortment and stock changes over time |
| Hobbyist developers | Pull a clean dataset of pottery supplies for a personal project |

### What it does

This Actor collects Sheffield Pottery products by product URL or collection handle, and returns each one as a flat row with its catalog data.

- 🔗 **Product and collection URLs:** paste any Sheffield Pottery product page or collection page and the Actor follows every link.
- 🏷️ **Collection handles:** specify handles like 'pottery-clay', 'kilns', or 'glazes' to scrape whole categories without building URLs.
- 📦 **Flat product rows:** each result is one product with its title, price, stock, variants, images, and description in a fixed schema.
- ⚙️ **Max items control:** set a hard cap from 1 to 1,000,000 products per run so you never overshoot.
- 📤 **Multiple export formats:** download as CSV, JSON, Excel, or XML, or push straight to a dataset.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Sheffield Pottery data

**📊 Track clay and glaze prices.**

A ceramic supply shop runs the Actor weekly on the pottery-clay and glazes collections to see which Sheffield Pottery products changed price and adjust their own catalog.

**🗂️ Build a product database.**

A pottery studio scrapes all kilns, wheels, and tools into a CSV so they can filter by price and stock before making a purchase.

**📈 Monitor stock availability.**

An e-commerce analyst scrapes the full catalog daily and flags products that went out of stock, so they can spot supply trends.

**🧪 Prototype a niche app.**

A developer pulls a clean JSON dataset of pottery supplies to test a search interface without dealing with messy HTML.

### Why choose this scraper

| | What you get |
|---|---|
| **No API key** | Scrape public Sheffield Pottery pages without registering or authenticating |
| **Collection-aware** | Scrape by handle, not by URL, so you can target entire categories |
| **Flat schema** | Every product comes back as one row, ready for spreadsheets or databases |
| **Scalable** | Collect up to a million products in a single run |

### How it compares

This Actor and the competitor both scrape Sheffield Pottery, but this one gives you more control over which collections to scrape and how many products to collect.

| Feature | ParseForge | Sheffield Pottery Scraper - Catalog & Prices |
|---|---|---|
| Scrape by collection handle | Yes | Not listed |
| Scrape by product URL | Yes | Not listed |
| Set maximum products per run | Yes | Not listed |
| Product names | Yes | Yes |
| Prices | Yes | Yes |
| Stock status | Yes | Yes |
| Variants | Yes | Yes |
| Images | Yes | Yes |
| Categories | Yes | Yes |
| Descriptions | Yes | Yes |

### Configure the run

Drive the Actor from product URLs, collection URLs, or collection handles, and set a maximum number of products to collect per run. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "startUrls": [
 {
 "url": "https://www.sheffield-pottery.com/collections/pottery-clay"
 }
 ],
 "maxItems": 10
}
```

A larger pull:

```json
{
 "startUrls": [
 {
 "url": "https://www.sheffield-pottery.com/collections/pottery-clay"
 }
 ],
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.01599 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $1.60 |
| 1,000 results | $15.99 |
| 10,000 results | $159.90 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Sheffield Pottery Scraper](https://apify.com/parseforge/sheffield-pottery-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Sheffield Pottery through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/sheffield-pottery-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your startUrls or collectionHandles are correct and that the pages are publicly accessible. Also make sure maxItems is set to at least 1.

**Why did the run stop before reaching maxItems?**

The Actor stops when it has collected maxItems products or when there are no more pages to follow. If a collection has fewer products than maxItems, it will finish early.

**Why are some product fields empty?**

Not every product page has the same fields. If a product does not have a description or variants, those fields will be empty in the output.

**Why did I get an error about invalid URLs?**

Make sure the URLs start with https://www.sheffield-pottery.com/ and point to product or collection pages. Other pages are not supported.

**Can I scrape the whole site?**

Yes, but you need to provide a starting point. Use the main collections page or a list of collection handles, and set maxItems high enough to cover the catalog.

### FAQ

| Question | Answer |
|---|---|
| Do I need an API key or login? | No. The Actor reads the public Sheffield Pottery website directly, so there is no registration or authentication. |
| Can I scrape a whole collection? | Yes. Paste a collection URL like https://www.sheffield-pottery.com/collections/pottery-clay, or use the collectionHandles field with handles like 'pottery-clay'. |
| What data do I get for each product? | Each product row includes its title, price, stock status, variants, images, description, and other catalog fields as returned by the page. |
| How many products can I scrape in one run? | You can set maxItems from 1 to 1,000,000. The Actor stops after collecting that many products. |
| Can I scrape only specific products? | Yes. Add individual product URLs to startUrls and the Actor will scrape only those pages. |
| What export formats are supported? | You can download the results as CSV, JSON, Excel, or XML, or access them through the Apify dataset API. |
| Does the Actor handle pagination? | Yes. When you provide a collection URL or handle, the Actor follows pagination links until it reaches maxItems or the end of the collection. |
| Is this legal to scrape? | You should only scrape public data in accordance with the website's terms of service and applicable laws. Apify provides the tool, and you are responsible for how you use it. |
| Can I schedule this Actor to run automatically? | Yes. On Apify you can set a schedule, such as daily or weekly, and the Actor will run with the same input each time. |
| What if a product page changes its layout? | The Actor uses reliable selectors, but if Sheffield Pottery changes its HTML, the scraper may need an update. You can report issues and we will fix them. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Sheffield Pottery. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `startUrls` (type: `array`):

URLs of Sheffield Pottery product pages or collection pages to scrape. Supports both product URLs (e.g., /products/...) and collection URLs (e.g., /collections/...).

## `maxItems` (type: `integer`):

How many products to collect per run.

## `collectionHandles` (type: `array`):

Collection handles to scrape (e.g., 'pottery-clay', 'kilns', 'glazes'). Use this instead of start URLs to scrape specific categories by their handle.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.sheffield-pottery.com/collections/pottery-clay"
    }
  ],
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with scraped product items

# 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 = {
    "startUrls": [
        {
            "url": "https://www.sheffield-pottery.com/collections/pottery-clay"
        }
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/sheffield-pottery-scraper").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 = {
    "startUrls": [{ "url": "https://www.sheffield-pottery.com/collections/pottery-clay" }],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/sheffield-pottery-scraper").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 '{
  "startUrls": [
    {
      "url": "https://www.sheffield-pottery.com/collections/pottery-clay"
    }
  ],
  "maxItems": 10
}' |
apify call parseforge/sheffield-pottery-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/sheffield-pottery-scraper"
        }
    }
}

```

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/i6yt51tDNZa26zgoH/builds/YoarOvnkSXzlrbLAh/openapi.json