NetEase Cloud Music Song, Chart & Playlist Scraper: MCP config, n8n workflow and API

{
  "mode": "search",
  "searchQueries": [
    "周杰伦"
  ],
  "searchType": "song",
  "artistOrder": "hot",
  "playlistCat": "华语",
  "maxTracksPerChart": 0,
  "commentOrder": "recommended",
  "maxCommentsPerItem": 100,
  "includeReplies": false,
  "maxRepliesPerComment": 20,
  "includeArtistProfile": false,
  "includeLyrics": false,
  "includeAlbumTracks": true,
  "includePlaylistTracks": true,
  "includeToplistInfo": true,
  "maxItems": 3
}

---
name: netease-cloud-music-song-chart-and-playlist
description: "NetEase Cloud Music songs, albums, artists, playlists, chart summaries, comments and lyrics metadata. Runs the Apify Actor dataspryva/netease-cloud-music-song-chart-and-playlist. Use when the user needs NetEase Cloud Music data with fields such as recordType, name, artist, album, rankPosition, chartName and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "dataspryva/netease-cloud-music-song-chart-and-playlist"
  store-url: "https://apify.com/dataspryva/netease-cloud-music-song-chart-and-playlist"
---

# NetEase Cloud Music Song, Chart & Playlist Scraper

Use this skill to fetch NetEase Cloud Music data with the Apify Actor `dataspryva/netease-cloud-music-song-chart-and-playlist` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | string, required | What to fetch. Each mode reads its own list field. |
| `searchQueries` | array | Free-text queries (mode=search). One or more artist, song, album or playlist names. |
| `searchType` | one of `song`, `album`, `artist`, `playlist` | Which catalog entity to search for (mode=search). |
| `songUrls` | array | music.163.com song URLs or bare song IDs, e.g. 186016. |
| `artistIds` | array | Artist IDs, music.163.com artist URLs, or exact artist names. |
| `artistOrder` | one of `hot`, `time` | Order the artist's song catalogue by popularity or release time (mode=byArtist). |
| `albumUrls` | array | music.163.com album URLs or bare album IDs. |
| `playlistUrls` | array | music.163.com playlist URLs or bare playlist IDs. Full tracklists are read. |
| `playlistCat` | string | NetEase playlist genre, scene or mood to browse (mode=byPlaylist). |
| `toplistIds` | array | Chart IDs, music.163.com toplist URLs, or Chinese/English chart names. Use `all` or leave empty for every current chart. |
| `maxTracksPerChart` | integer | Limit tracks read from each chart before the global max items cap (mode=byToplist). 0 reads every track. |
| `commentUrls` | array | Song, album, playlist or chart URLs/IDs. A bare ID is treated as a song; use `album:123`, `playlist:123` or `chart:123` to be explicit. |
| `commentOrder` | one of `recommended`, `hot` | Recommended comments or NetEase's hot-comment selection (mode=comments). |
| `maxCommentsPerItem` | integer | Maximum top-level comments read per song, album, playlist or chart (mode=comments). NetEase stops anonymous pagination around 1,100. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "search",
  "searchQueries": [
    "周杰伦"
  ],
  "searchType": "song",
  "artistOrder": "hot",
  "playlistCat": "华语",
  "maxTracksPerChart": 0,
  "commentOrder": "recommended",
  "maxCommentsPerItem": 100,
  "includeReplies": false,
  "maxRepliesPerComment": 20,
  "includeArtistProfile": false,
  "includeLyrics": false,
  "includeAlbumTracks": true,
  "includePlaylistTracks": true,
  "includeToplistInfo": true,
  "maxItems": 3
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/dataspryva~netease-cloud-music-song-chart-and-playlist/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/dataspryva~netease-cloud-music-song-chart-and-playlist/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `recordType`, `name`, `artist`, `album`, `rankPosition`, `chartName`, `playlistName`, `durationSec`, `sourceUrl`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.