Skip to main content

A package for scraping content from the MSCI.com ESG Ratings Corporate Search Tool

Project description

MSCI ESG (Environment, Social, Governance) Corporate Search Tool Scraper


MSCI Inc., is an American finance company headquartered in New York City and serving as a global provider of equity, fixed income, hedge fund stock market indexes, multi-asset portfolio analysis tools and ESG products. It publishes the MSCI BRIC, MSCI World and MSCI EAFE Indexes.

ESG Risk Ratings provided by MSCI are designed to measure a company's resilience to long-term, industry material environmental, social and governance (ESG) risks. MSCI uses a rules-based methodology to identify industry leaders and laggards according to their exposure to ESG risks and how well they manage those risks relative to peers.


What is it?

This is a simple package that uses Selenium to scrape content from the MSCI.com ESG (Environment, Social, Governance) Risk Corporate Search Tool.


Why was this created?

ESG risk ratings play an important role in stock market analysis, and previously, the only way of obtaining this data from MSCI was to open the Search Tool in a browser, search for a symbol, and click on one of the autosuggested results. This automates the collection of the important ESG risk rating data, both historical and current, and returns it in JSON format. This project was built as a supplemental tool for StockScope, which is a Django web application in development for providing AI-driven Stock Market querying and alerting capabilities.


How to Use

The following is a sample Python code snippet that uses this package.

from msci_esg.ratefinder import ESGRateFinder

# Create an ESGRateFinder object, optionally passing in debug=True for more print statements
ratefinder = ESGRateFinder()

# Call the ratefinder object's get_esg_rating method, passing in the Apple stock symbol and 
# a JS timeout of 5 seconds (this is how long the Selenium web driver should wait for JS to execute 
# before scraping content)
response = ratefinder.get_esg_rating(
    symbol="AAPL",
    js_timeout=5
)
# The response is a dictionary; print it
print(response)
# Will look like: 
# {'rating-paragraph': 'Apple is average among 52 companies in the technology hardware, storage & peripherals industry.', 'current': {'esg_rating': 'bbb', 'esg_category': 'average'}, 'history': {'oct-16': 'a', 'aug-17': 'a', 'sep-18': 'a', 'nov-19': 'a', 'dec-20': 'bbb'}}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py-msci-esg-0.0.5.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

py_msci_esg-0.0.5-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file py-msci-esg-0.0.5.tar.gz.

File metadata

  • Download URL: py-msci-esg-0.0.5.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.6.12

File hashes

Hashes for py-msci-esg-0.0.5.tar.gz
Algorithm Hash digest
SHA256 fcbb4ffe256eb9b443b1d8d8b009639f404ed32c03a78b33bca73f5a6e679531
MD5 9acfd91394ad41b74127f00f8c57bd65
BLAKE2b-256 4f56bced699d0b9137762582cd9b9ef65e347b1cafb2be84c5d1080909acc4f0

See more details on using hashes here.

File details

Details for the file py_msci_esg-0.0.5-py3-none-any.whl.

File metadata

  • Download URL: py_msci_esg-0.0.5-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/40.6.2 requests-toolbelt/0.9.1 tqdm/4.57.0 CPython/3.6.12

File hashes

Hashes for py_msci_esg-0.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 d5b6b582b6e586fecc94e929a3e5518a2acc136e6d7a50f8666d4c810d680085
MD5 81768d594880b59583bc5cba074bf63d
BLAKE2b-256 d6c952c9c183558653c79d7402b21f27d65d7aeac01aa33261c9c7a557054a60

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page