# Yahoo! Jobcatalog List Scraper

This template extracts job company information (such as company name, annual salary, and overtime hours) from Yahoo! Jobcatalog Catalog.

- Template page: [https://www.octoparse.com/template/jobcatalog-list](https://www.octoparse.com/template/jobcatalog-list)
- 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 general web pages.

## Output

The current workflow extracts 9 fields, including `アドレス`, `クチコミ一覧リンク`, `平均年収`, `平均残業時間`, `従業員数`, `業種業界`, `求人情報詳細ページ`, `社名`, `評価件数`.

## 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 URL, Pagination and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URL

Required. URL Constraints: minItems=1; maxItems=20; items.minLength=10.

### Pagination

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

## How to Use

## Yahoo! Jobcatalog List Scraper

This template collects job company information (company name, annual salary, overtime hours, etc.) from listing pages on [Yahoo! Jobcatalog](https://jobcatalog.yahoo.co.jp/).

### Input

- **URL** (required) – Enter one or more URLs, one per line.
- **Pagination** (optional) – Enter a number from 1 to 100.

### Output

Each row contains these fields:

- `社名`
- `求人情報詳細ページ`
- `業種業界`
- `アドレス`
- `平均年収`
- `平均残業時間`
- `評価件数`
- `クチコミ一覧リンク`
- `従業員数`

### How to Use

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

### Limitations

- Only collects data displayed on listing pages. Detail-page data is not included.
- `評価件数`, `クチコミ一覧リンク`, and `従業員数` may be empty if the source does not provide them.

### Tips

- Start with a few inputs and review results before scaling.
- Use the most specific valid URL to reduce unrelated records.
- Use a stable identifier (e.g., `社名`, `求人情報詳細ページ`) as a deduplication key.

## 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

- [Yahoo Search Scraper](https://www.octoparse.com/template/yahoo-search-scraper)
- [Yahoo Shopping Review Scraper (by URL)](https://www.octoparse.com/template/yahoo-shopping-review-scraper)
- [Yahoo Japan News Comments Scraper](https://www.octoparse.com/template/yahoo-news-comments-scraper)
- [Yahoo Auctions Product Scraper](https://www.octoparse.com/template/yahoo-auctions-product-scraper)
- [Yahoo Finance Scraper](https://www.octoparse.com/template/yahoo-finance-scraper)

## Input Schema

```json
{
  "title": "Yahoo! Jobcatalog List Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL": {
      "title": "URL",
      "description": "URL",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 10
      },
      "minItems": 1,
      "maxItems": 20,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "pagination": {
      "title": "Pagination",
      "description": "Pagination",
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRL"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "pagination": 10.0,
  "uRL": [
    "https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction"
  ]
}
```

Example 2

```json
{
  "pagination": 10.0,
  "uRL": [
    "https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction"
  ]
}
```

Example 3

```json
{
  "pagination": 10.0,
  "uRL": [
    "https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction"
  ]
}
```

Example 4

```json
{
  "pagination": 10.0,
  "uRL": [
    "https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction"
  ]
}
```

Example 5

```json
{
  "pagination": 10.0,
  "uRL": [
    "https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "アドレス": {
      "type": "string",
      "description": ""
    },
    "クチコミ一覧リンク": {
      "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": "Yahoo! Jobcatalog List 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
{
  "アドレス": " 愛知県刈谷市昭和町１丁目１番地",
  "クチコミ一覧リンク": "https://jobcatalog.yahoo.co.jp/company/1000039155/review/",
  "平均年収": "534万円",
  "平均残業時間": "15.6",
  "従業員数": "2300",
  "業種業界": "自動車 ",
  "求人情報詳細ページ": "https://jobcatalog.yahoo.co.jp/company/1000039155/jobs/",
  "社名": "",
  "評価件数": "73件のクチコミ"
}
```

Example 2

```json
{
  "アドレス": " 愛知県名古屋市熱田区六野１丁目２番地９",
  "クチコミ一覧リンク": "https://jobcatalog.yahoo.co.jp/company/2000748646/review/",
  "平均年収": "617万円",
  "平均残業時間": "11.3",
  "従業員数": "9300",
  "業種業界": "自動車 ",
  "求人情報詳細ページ": "https://jobcatalog.yahoo.co.jp/company/2000748646/jobs/",
  "社名": "",
  "評価件数": "159件のクチコミ"
}
```

Example 3

```json
{
  "アドレス": " 愛知県刈谷市昭和町１丁目１番地",
  "クチコミ一覧リンク": "https://jobcatalog.yahoo.co.jp/company/1000039155/review/",
  "平均年収": "528万円",
  "平均残業時間": "16.3",
  "従業員数": "2300",
  "業種業界": "自動車 ",
  "求人情報詳細ページ": "https://jobcatalog.yahoo.co.jp/company/1000039155/jobs/",
  "社名": "",
  "評価件数": "73件のクチコミ"
}
```

Example 4

```json
{
  "アドレス": " 愛知県刈谷市昭和町１丁目１番地",
  "クチコミ一覧リンク": "https://jobcatalog.yahoo.co.jp/company/1000039155/review/",
  "平均年収": "528万円",
  "平均残業時間": "16.3",
  "従業員数": "2300",
  "業種業界": "自動車 ",
  "求人情報詳細ページ": "https://jobcatalog.yahoo.co.jp/company/1000039155/jobs/",
  "社名": "株式会社デンソーソリューション",
  "評価件数": "73件のクチコミ"
}
```

Example 5

```json
{
  "アドレス": " 愛知県刈谷市昭和町１丁目１番地",
  "クチコミ一覧リンク": "https://jobcatalog.yahoo.co.jp/company/1000039155/review/",
  "平均年収": "528万円",
  "平均残業時間": "16.3",
  "従業員数": "2300",
  "業種業界": "自動車 ",
  "求人情報詳細ページ": "https://jobcatalog.yahoo.co.jp/company/1000039155/jobs/",
  "社名": "株式会社デンソーソリューション",
  "評価件数": "69件の評価"
}
```

## 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": "jobcatalog-list",
  "taskName": "Yahoo! Jobcatalog List Scraper",
  "parameters": "{\"pagination\":10.0,\"uRL\":[\"https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"pagination\":10.0,\"uRL\":[\"https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "jobcatalog-list",
        "taskName": "Yahoo! Jobcatalog List 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": "jobcatalog-list",
  "taskName": "Yahoo! Jobcatalog List Scraper",
  "parameters": "{\"pagination\":10.0,\"uRL\":[\"https://jobcatalog.yahoo.co.jp/company/search/?area=23000&industry=0712&order=desc&sort=satisfaction&tab=satisfaction\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `jobcatalog-list`, 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/jobcatalog-list.json)
- [Manifest](https://www.octoparse.com/templates/jobcatalog-list-manifest.json)