PHPackages                             mamoot/pokemon-card-scraper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. mamoot/pokemon-card-scraper

ActiveLibrary

mamoot/pokemon-card-scraper
===========================

Simple PHP library to scrap Pokémon cards data from official Pokémon Website

20PHP

Since May 16Pushed 4y ago1 watchersCompare

[ Source](https://github.com/mamoot64/pokemon-card-scraper)[ Packagist](https://packagist.org/packages/mamoot/pokemon-card-scraper)[ RSS](/packages/mamoot-pokemon-card-scraper/feed)WikiDiscussions main Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Pokémon Card Scraper
====================

[](#pokémon-card-scraper)

🔥 **WORK IN PROGRESS**

Simple PHP Pokémon card scraper based on [Goutte](https://github.com/FriendsOfPHP/Goutte) web scraper and solid Symfony Components (DomCrawler, BrowserKit and HttpClient).
Unit tests are made with [Pest](https://github.com/pestphp/pest), an elegant wrapper around PHPUnit.

***Warning!***
Seems working for "Sun and Moon" & "Sword And Shield" series.
Some modelization elements need to be enhanced (ability, subtype, ...)
Please, be patient ;)

Installation
------------

[](#installation)

Use [Composer](http://getcomposer.org/) to install the package:

```
$ composer require mamoot/pokemon-card-scraper

```

Basic usage and examples
------------------------

[](#basic-usage-and-examples)

### Create the scraper instance

[](#create-the-scraper-instance)

```
use Goutte\Client;
use Scraper\PokemonCardScraper;

// We want to scrap Sword And Shield - Darkness Ablaze extension
$pokemonCardScraper = (new PokemonCardScraper(new Client()))
  ->setSerieCollection('ss-series')
  ->setCollectionCode('swsh3');
```

### And scrap!

[](#and-scrap)

```
// Base Pokémon card
$baseCardDetails = $pokemonCardScraper->setCardNumber(120)->scrap();
dump($baseCardDetails);

// Evolutive Pokémon card
$evolutiveCardDetails = $pokemonCardScraper->setCardNumber(38)->scrap();
dump($evolutiveCardDetails);

// Trainer Pokémon card
$trainerCardDetails = $pokemonCardScraper->setCardNumber(160)->scrap();
dump($trainerCardDetails);

// Base Pokémon card in English
$baseCardDetailsInEnglish = $pokemonCardScraper->setLanguage('uk')->setCardNumber(1)->scrap();
dump($baseCardDetailsInEnglish);

// Evolutive Pokémon card in Italian
$evolutiveCardDetailsInItalien = $pokemonCardScraper->setLanguage('it')->setCardNumber(38)->scrap();
dump($evolutiveCardDetailsInItalien);

// Trainer Pokémon card in Spanish
$trainerCardDetailsInSpanish = $pokemonCardScraper->setLanguage('es')->setCardNumber(160)->scrap();
dump($trainerCardDetailsInSpanish);
```

All given examples can be tested with ease:

```
$ git clone git@github.com:mamoot64/pokemon-card-scraper.git
$ cd pokemon-card-scraper
$ composer install
$ php example/card-scraper.php

```

### Dump example

[](#dump-example)

```
^ Scraper\Domain\PokemonCard^ {#16
  -evolutionOf: "Basic"
  -pokemonType: "Water"
  -healthPoint: 30
  -retreatCost: 1
  -ability: null
  -attacks: array:1 [
    0 => Scraper\Domain\Attack^ {#74
      -name: "Tit’Sieste"
      -damage: null
      -description: "Soignez 20 dégâts de ce Pokémon."
      -cost: array:1 [
        0 => "Colorless"
      ]
    }
  ]
  -weakness: Scraper\Domain\Weakness^ {#58
    -energyType: "Lightning"
    -energyCost: 1
  }
  -resistance: Scraper\Domain\Resistance^ {#15
    -resistanceType: null
    -resistanceCost: null
  }
  -cardName: "Barpau"
  -imageCardUrl: "https://assets.pokemon.com/assets/cms2-fr-fr/img/cards/web/SWSH3/SWSH3_FR_38.png"
  -masterType: "Pokémon"
  -subType: "de base"
  -extension: Scraper\Domain\Extension^ {#66
    -extensionName: "Ténèbres Embrasées"
    -extensionIconUrl: "https://assets.pokemon.com/assets/cms-fr-fr/img/tcg/expansion-symbols/_40x40/swsh3-expansion-symbol.png"
  }
  -information: Scraper\Domain\Information^ {#78
    -cardNumber: "38/189"
    -rarity: "Common"
    -illustrator: "HYOGONOSUKE"
  }
}
```

### Available languages

[](#available-languages)

fr / en / it / es / de

French (fr) is the default language.

### Execute test suite

[](#execute-test-suite)

If you want to run the tests you should run the following commands:

```
$ git clone git@github.com:mamoot64/pokemon-card-scraper.git
$ cd pokemon-card-scraper
$ composer install
$ composer test

```

If you want to generate coverage with HTML report, run:

```
$ composer test-coverage-html

```

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/3f7125a1568f9e92a454e5a9681c8bc8f9f602550a939ce2e374ca7e4f703940?d=identicon)[mamoot](/maintainers/mamoot)

---

Top Contributors

[![mamoot40](https://avatars.githubusercontent.com/u/98086916?v=4)](https://github.com/mamoot40 "mamoot40 (5 commits)")

### Embed Badge

![Health badge](/badges/mamoot-pokemon-card-scraper/health.svg)

```
[![Health](https://phpackages.com/badges/mamoot-pokemon-card-scraper/health.svg)](https://phpackages.com/packages/mamoot-pokemon-card-scraper)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)