# Jyuku Navi School Ranking Scraper

Template for extracting data (name of school, target grade, number of stars and ratings, etc.) from Jyuku Navi by URLs.

- Template page: [https://www.octoparse.com/template/jyuku-navi-school-ranking-scraper](https://www.octoparse.com/template/jyuku-navi-school-ranking-scraper)
- Categories: Jobs
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 8 fields, including `ページのURL`, `ランキング`, `地域`, `塾名`, `対象学年`, `授業形式`, `星`, `評価数`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Enter URL(up to 50 per run), Number of pages (1~100) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Enter URL(up to 50 per run)

Required. https://www.jyukunavi.jp/rank/40.html Constraints: minItems=1; maxItems=50.

### Number of pages (1~100)

Optional. Constraints: minimum=1, maximum=100.

## How to Use

# Jyuku Navi School Ranking Scraper

Collects school ranking data from Jyuku Navi by URLs: school name, target grade, stars, ratings, and more. Data source: <https://www.jyukunavi.jp/>

## Inputs

- **Enter URL(up to 50 per run)** (required): Enter one or more values, one per line.
- **Number of pages (1~100)** (optional): Enter a number from 1 to 100.

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields above.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

## Output Fields

- `地域`
- `ランキング`
- `塾名`
- `対象学年`
- `授業形式`
- `星`
- `評価数`
- `ページのURL`

Example:

```json
{
  "地域": "吉野川市",
  "ランキング": "1位",
  "塾名": "個別指導Ａｘｉｓ（アクシス）",
  "対象学年": "小1～6 中1～3 高1～3 浪",
  "授業形式": "個別指導",
  "星": "3.59点",
  "評価数": "1,549件",
  "ページのURL": "https://www.jyukunavi.jp/rank/36205.html"
}
```

## Limits and Notes

- This template currently has no per-line charge.
- Maximum 50 URLs per run; pages limited to 1–100.
- Collects only the fields listed above from listing pages; it does not add data that Jyukunavi does not display.
- Fields such as `星`, `評価数`, and `ページのURL` can be empty when the source record does not provide them.
- Runs can be scheduled locally or in the cloud. Scheduling and API access may require a paid Octoparse plan.
- Export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to reporting/AI workflows through Octoparse OpenAPI or the AgentTools API: `https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates`

## Tips

- Start with one or a few inputs and review the returned rows before scaling the task.
- Use the most specific valid **Enter URL(up to 50 per run)** to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the output fields as the deduplication key when available.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Guru Navi Restaurant Scraper](https://www.octoparse.com/template/gurunavi-shop-restaurant-scraper)
- [Hwahae Category Trending Ranking Scraper](https://www.octoparse.com/template/hwahae)
- [Bic Camera Search Results Scraper](https://www.octoparse.com/template/bic-camera-search-results-scraper)
- [Google Search Scraper](https://www.octoparse.com/template/google-search-scraper)
- [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)

## Input Schema

```json
{
  "title": "Jyuku Navi School Ranking Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "enter_URL": {
      "title": "Enter URL(up to 50 per run)",
      "description": "https://www.jyukunavi.jp/rank/40.html",
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 50,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_pages": {
      "title": " Number of pages (1~100)",
      "description": "",
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "enter_URL"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "enter_URL": [
    "https://www.jyukunavi.jp/rank/40.html"
  ]
}
```

Example 2

```json
{
  "enter_URL": [
    "https://www.jyukunavi.jp/rank/40.html"
  ]
}
```

Example 3

```json
{
  "enter_URL": [
    "https://www.jyukunavi.jp/rank/40.html"
  ]
}
```

Example 4

```json
{
  "enter_URL": [
    "https://www.jyukunavi.jp/rank/40.html"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "ページのURL": {
      "type": "string",
      "description": ""
    },
    "ランキング": {
      "type": "string",
      "description": ""
    },
    "地域": {
      "type": "string",
      "description": ""
    },
    "塾名": {
      "type": "string",
      "description": ""
    },
    "対象学年": {
      "type": "string",
      "description": ""
    },
    "授業形式": {
      "type": "string",
      "description": ""
    },
    "星": {
      "type": "string",
      "description": ""
    },
    "評価数": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Jyuku Navi School Ranking Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "ページのURL": "https://www.jyukunavi.jp/rank/40.html",
  "ランキング": "1位",
  "地域": "福岡県",
  "塾名": "個別教室のトライ",
  "対象学年": "\n\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t年少～年長\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t小1～6\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t中1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t高1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t浪\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t",
  "授業形式": "個別指導",
  "星": "3.45点",
  "評価数": "10,444件"
}
```

Example 2

```json
{
  "ページのURL": "https://www.jyukunavi.jp/rank/40.html",
  "ランキング": "1位",
  "地域": "福岡県",
  "塾名": "個別教室のトライ",
  "対象学年": "\n\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t年少～年長\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t小1～6\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t中1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t高1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t浪\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t",
  "授業形式": "個別指導",
  "星": "3.45点",
  "評価数": "10,271件"
}
```

Example 3

```json
{
  "ページのURL": "https://www.jyukunavi.jp/rank/40.html",
  "ランキング": "/",
  "地域": "福岡県",
  "塾名": "個別指導塾スタンダード",
  "対象学年": "\n\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t小3～6\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t中1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t高1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t浪\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t",
  "授業形式": "個別指導",
  "星": "3.33点",
  "評価数": "686件"
}
```

Example 4

```json
{
  "ページのURL": "https://www.jyukunavi.jp/rank/40.html",
  "ランキング": "1位",
  "地域": "福岡県",
  "塾名": "個別教室のトライ",
  "対象学年": "\n\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t年少～年長\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t小1～6\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t中1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t高1～3\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t浪\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t",
  "授業形式": "個別指導",
  "星": "3.45点",
  "評価数": "10,200件"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "Jyuku-navi-school-ranking-scraper",
  "taskName": "Jyuku Navi School Ranking Scraper",
  "parameters": "{\"enter_URL\":[\"https://www.jyukunavi.jp/rank/40.html\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"enter_URL\":[\"https://www.jyukunavi.jp/rank/40.html\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "Jyuku-navi-school-ranking-scraper",
        "taskName": "Jyuku Navi School Ranking Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "Jyuku-navi-school-ranking-scraper",
  "taskName": "Jyuku Navi School Ranking Scraper",
  "parameters": "{\"enter_URL\":[\"https://www.jyukunavi.jp/rank/40.html\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `Jyuku-navi-school-ranking-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/jyuku-navi-school-ranking-scraper.json)
- [Manifest](https://www.octoparse.com/templates/jyuku-navi-school-ranking-scraper-manifest.json)
