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.6.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: py-msci-esg-0.0.6.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.6.tar.gz
Algorithm Hash digest
SHA256 d75ec65865a8c57510110c3addd29532d4e8f9be6e6d4b4d8f111ee532f187a9
MD5 d88a1aaf848f1821da022986b5e5bd81
BLAKE2b-256 12c8a3d59cfe44df21d6857b7bd8f5a2799a9d086023d509ab53db4a169aa742

See more details on using hashes here.

File details

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

File metadata

  • Download URL: py_msci_esg-0.0.6-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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 f56cac5f215a7c52f3d5f5a01c45e0f5c2a1a04e2489fed1692981e3c872a09d
MD5 773b3c2dd515cedbc14f64a12e608079
BLAKE2b-256 1ee4a072dbf8459a25db844bb708e2766396005f99cfeb7634c67ca9522e88e0

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