# Guokr Scraper — China Science Articles (果壳) (`hipersoft/guokr-scraper`) Actor

Scrape Guokr (果壳) popular-science articles: title, summary, preface, author, image and publish date.

- **URL**: https://apify.com/hipersoft/guokr-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** News, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.001 / article scraped

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?

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

## Guokr Scraper — Chinese Science Articles, Authors & Publish Dates (果壳)

**Scrape Guokr** (果壳), one of China's leading popular-science and knowledge communities, into clean JSON, CSV, Excel or XML. This Guokr scraper extracts **article titles, summaries, prefaces, authors, images, editor picks and publish dates** from the article feed — structured, ready for research, analytics or LLM pipelines. A fast, reliable, no-code way to build a China science-content dataset.

Instead of copy-pasting articles by hand, point the Actor at the feed, set how many items you want, and get every article as a clean row. It's one of the cheapest ways to collect Chinese popular-science content at scale.

![Guokr Scraper input — options in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/guokr-scraper-input.png)

### What does the Guokr Scraper do?

The Guokr Scraper crawls and extracts public Guokr (果壳) content from the article feed and returns it as structured data points — **title, summary, preface, author, author profile URL, cover image, editor-pick flag, publish and last-modified dates, and the article URL**. Set a single limit and export the results as JSON, CSV, Excel or XML, or pull them straight from the API for datasets, media monitoring, content aggregation or machine-learning corpora.

### What data can you scrape from Guokr?

| Group | Fields |
|---|---|
| 📰 **Article** | id, title, summary, preface, cover image, article URL |
| ✍️ **Author** | author name, author key, author profile URL |
| 🗓️ **Dates** | published timestamp, last-modified timestamp, collected timestamp |
| ⭐ **Editorial** | editor-recommended flag |

### Use cases

- **Build a China science-content dataset** — thousands of popular-science articles with titles, summaries and metadata for analysis or training data.
- **Feed articles to an LLM** — summaries, prefaces and titles make ready input for RAG knowledge bases, translation and content repurposing.
- **Media & topic monitoring** — track what a major Chinese science community is publishing, and when.
- **Content aggregation** — surface and republish (within terms) the latest science stories for a newsletter or portal.
- **Trend & topic discovery** — spot emerging themes across science, technology and research coverage.
- **Author & editorial research** — see which authors publish what, and which pieces get the editor-pick flag.
- **Academic & market research** — study publishing cadence, topics and editorial signals from public data.

### How to scrape Guokr data

1. Click **Try for free / Start** to open the Guokr Scraper.
2. Set **`maxItems`** — how many articles you want from the feed.
3. Click **Run**.
4. Watch the dataset fill with articles in real time.
5. Download the results as **JSON, CSV, Excel or XML**, or pull them from the API.

### Input

The Guokr Scraper takes a single, simple input: how many articles to collect.

```json
{
  "maxItems": 200
}
```

| Field | Type | Description |
|---|---|---|
| `maxItems` | integer | Maximum number of articles to scrape from the Guokr feed (default 100). |

### Output

![Guokr Scraper output — a science-articles dataset with author and publish date](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/guokr-scraper-output.png)

Each article is one dataset item:

```json
{
  "id": 469796,
  "title": "谷歌 DeepMind 解散 AlphaFold 团队；字节跳动重组人工智能业务线……",
  "summary": "……",
  "preface": "……",
  "author": "果壳",
  "authorKey": "sbhkv5",
  "authorUrl": "https://www.guokr.com/i/1712348897/",
  "image": "https://1-im.guokr.com/....jpg",
  "isEditorRecommend": false,
  "publishedAt": "2026-07-30T12:15:02.974Z",
  "modifiedAt": "2026-07-30T12:20:00.000Z",
  "url": "https://www.guokr.com/article/469796/",
  "collectedAt": "2026-07-30T12:00:00.000Z"
}
```

#### Output schema

| Field | Type | Description |
|-------|------|-------------|
| `id` | integer | Guokr article ID. |
| `title` | string | Article title (Chinese). |
| `summary` | string | Short article summary. |
| `preface` | string | Article preface / lead text. |
| `author` | string | Author display name. |
| `authorKey` | string | Author identifier key. |
| `authorUrl` | string (URL) | Link to the author's Guokr profile. |
| `image` | string (URL) | Cover image URL for the article. |
| `isEditorRecommend` | boolean | Whether the article is flagged as an editor pick. |
| `publishedAt` | string (ISO date) | When the article was published. |
| `modifiedAt` | string (ISO date) | When the article was last modified. |
| `url` | string (URL) | Canonical URL of the article on Guokr. |
| `collectedAt` | string (ISO date) | When the item was collected by the run. |

### Need more Chinese content data?

Building a wider China content dataset? Pair the Guokr Scraper with our other scrapers for Chinese tech, science and media platforms:

- [SSPAI Scraper](https://apify.com/hipersoft/sspai-scraper) — Chinese tech and productivity articles.
- [Juejin Scraper](https://apify.com/hipersoft/juejin-scraper) — developer and programming posts from 掘金.
- [IThome Scraper](https://apify.com/hipersoft/ithome-scraper) — Chinese tech news and headlines.
- [Bilibili Scraper](https://apify.com/hipersoft/bilibili-scraper) — videos, creators and stats from Bilibili.

### FAQ

**Do I need any setup or a login to scrape Guokr?**
No. There's no setup and no login — just set `maxItems` and run. It's a no-code tool: everything happens in the Apify Console.

**How many articles can I scrape per run?**
As many as the feed provides — set `maxItems` to control the cap (up to 100,000). Start small to preview, then raise the limit for a full dataset.

**How much does it cost?**
You pay only per article you get, which makes this one of the cheapest ways to collect Chinese science content — no monthly minimum and no per-tool licensing.

**What export formats are supported?**
JSON, CSV, Excel and XML, plus webhooks and the Apify API.

**What about likes, comments or view counts?**
The feed does not expose engagement metrics, so this Actor focuses on article content and metadata — titles, summaries, prefaces, authors, images and dates.

**How fresh is the data?**
Each run reads the current feed, so you get the latest articles at the time of the run. The `collectedAt` timestamp records exactly when each item was captured.

**Can I automate or integrate the Guokr Scraper?**
Yes. The Guokr Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes — get a notification, or kick off another process such as loading your data downstream.

**Is scraping Guokr legal?**
The Actor collects only public data. You are responsible for how you use it and for complying with Guokr's terms and applicable laws.

### Related Actors

- [SSPAI Scraper](https://apify.com/hipersoft/sspai-scraper) — Chinese tech and productivity articles.
- [Juejin Scraper](https://apify.com/hipersoft/juejin-scraper) — developer posts from 掘金.
- [IThome Scraper](https://apify.com/hipersoft/ithome-scraper) — Chinese tech news.
- [Bilibili Scraper](https://apify.com/hipersoft/bilibili-scraper) — videos and creators.

### Notes

Original clean-room implementation. Returns only public Guokr data; you are responsible for how you use the data and for complying with Guokr's terms. This is an independent tool and is not affiliated with or endorsed by Guokr (果壳).

# Actor input Schema

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

Maximum articles to scrape from the Guokr feed.

## Actor input object example

```json
{
  "maxItems": 100
}
```

# Actor output Schema

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

The scraped results as dataset 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/guokr-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/guokr-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 '{}' |
apify call hipersoft/guokr-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/guokr-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/txj4foWEUOoEY0vxv/builds/fgdON5aEabNUWI9xm/openapi.json