porto-digital-companies

Biblioteca JavaScript para listar, buscar e filtrar empresas cadastradas no diretório de empresas embarcadas do Porto Digital.

Este pacote não é oficial do Porto Digital.

Instalação

npm install porto-digital-companies

Uso básico

import {
  getCompanies,
  getCompanyById,
  searchCompanies,
  getAllCompanys,
  getStats
} from "porto-digital-companies";

console.log(getAllCompanys());
console.log(getCompanyById(3134).name());
console.log(getCompanyById(3134).website());
console.log(getCompanyById(3134).createMapsLink());

Listar todas as empresas

import { getCompanies } from "porto-digital-companies";

const companies = getCompanies();

console.log(companies);

Retorna todas as empresas com os dados já tratados.

Listar apenas nomes e IDs

import { getAllCompanys } from "porto-digital-companies";

console.log(getAllCompanys());

Exemplo de retorno:

[
  {
    id: 3134,
    name: "Virtualizze"
  },
  {
    id: 2721,
    name: "LIda - Mobilidade Ativa"
  }
]

Buscar empresa por ID

import { getCompanyById } from "porto-digital-companies";

const company = getCompanyById(3134);

console.log(company.id());
console.log(company.name());
console.log(company.website());
console.log(company.city());
console.log(company.business());
console.log(company.address());

Exemplo:

const company = getCompanyById(3134);

console.log(company.name());
// Virtualizze

Retornar a empresa completa

const company = getCompanyById(3134);

console.log(company.all());

Gerar link do Google Maps

const company = getCompanyById(3134);

console.log(company.createMapsLink());

Exemplo de retorno:

https://www.google.com/maps/search/?api=1&query=Rua%20Rocha%20Pita%2C%20156%2C%20Santo%20Amaro%2C%20Recife%2C%20PE%2C%2050040030

Buscar empresa por slug

import { getCompanyBySlug } from "porto-digital-companies";

console.log(getCompanyBySlug("virtualizze"));

Buscar empresas por texto

import { searchCompanies } from "porto-digital-companies";

console.log(searchCompanies("web"));
console.log(searchCompanies("inteligência artificial"));
console.log(searchCompanies("Recife"));
console.log(searchCompanies("Startup"));

A busca procura em campos como:

• nome
• descrição
• modelo de negócio
• tipo da empresa
• porte
• cidade
• bairro
• áreas de atuação
• tecnologias

Retornar campos específicos de uma empresa

import { getCompanyById } from "porto-digital-companies";

const company = getCompanyById(3134);

console.log(
  company.fields([
    "id",
    "name",
    "contact.website",
    "address.city",
    "business.type"
  ])
);

Exemplo de retorno:

{
  id: 3134,
  name: "Virtualizze",
  contact: {
    website: "https://www.virtualizze.com"
  },
  address: {
    city: "Recife"
  },
  business: {
    type: "Startup"
  }
}

Buscar empresas e retornar campos específicos

import { searchCompanyFields } from "porto-digital-companies";

console.log(
  searchCompanyFields("web", [
    "id",
    "name",
    "contact.website",
    "address.city",
    "technologies"
  ])
);

Filtrar por tecnologia

import { getCompaniesByTechnology } from "porto-digital-companies";

console.log(getCompaniesByTechnology("Web"));
console.log(getCompaniesByTechnology("Inteligência Artificial"));
console.log(getCompaniesByTechnology("Cloud Computing"));

Filtrar por tipo de empresa

import { getCompaniesByType } from "porto-digital-companies";

console.log(getCompaniesByType("Startup"));
console.log(getCompaniesByType("Empresas"));

Filtrar por porte

import { getCompaniesBySize } from "porto-digital-companies";

console.log(getCompaniesBySize("Microempresa"));
console.log(getCompaniesBySize("Empresa de Médio Porte"));

Filtrar por modelo de negócio

import { getCompaniesByBusinessModel } from "porto-digital-companies";

console.log(getCompaniesByBusinessModel("Empresa para Empresa"));
console.log(getCompaniesByBusinessModel("Empresa para Consumidor"));

Filtrar por cidade

import { getCompaniesByCity } from "porto-digital-companies";

console.log(getCompaniesByCity("Recife"));
console.log(getCompaniesByCity("Caruaru"));

Filtrar por bairro

import { getCompaniesByNeighborhood } from "porto-digital-companies";

console.log(getCompaniesByNeighborhood("Bairro do Recife"));
console.log(getCompaniesByNeighborhood("Santo Amaro"));

Empresas de Recife

import { getCompaniesFromRecife } from "porto-digital-companies";

console.log(getCompaniesFromRecife());

Empresas no Bairro do Recife

import { getCompaniesFromBairroDoRecife } from "porto-digital-companies";

console.log(getCompaniesFromBairroDoRecife());

Listar startups

import { getStartups } from "porto-digital-companies";

console.log(getStartups());

Empresas com site

import { getCompaniesWithWebsite } from "porto-digital-companies";

console.log(getCompaniesWithWebsite());

Empresa aleatória

import { getRandomCompany } from "porto-digital-companies";

console.log(getRandomCompany());

Estatísticas

import { getStats } from "porto-digital-companies";

console.log(getStats());

Exemplo de retorno:

{
  total: 2919,
  byType: {
    Startup: 2070,
    Empresas: 415
  },
  bySize: {
    "ME - Microempresa": 1615
  },
  byBusinessModel: {
    "Empresa para Empresa": 2027
  },
  byCity: {
    Recife: 618
  },
  byNeighborhood: {
    "Bairro Do Recife": 307
  },
  byTechnology: {
    Web: 629,
    "Inteligência Artificial (IA)": 866
  }
}

Dados brutos

Se quiser acessar os dados originais sem tratamento:

import { getCompaniesRaw } from "porto-digital-companies";

console.log(getCompaniesRaw());

Funções disponíveis

Dados gerais

• getCompanies()
• getCompaniesRaw()
• getAllCompanys()
• getRandomCompany()
• getStats()

Busca

• getCompanyById(id)
• getCompanyBySlug(slug)
• searchCompanies(query)
• searchCompanyFields(query, fields)

Filtros

• getCompaniesByTechnology(technology)
• getCompaniesByType(type)
• getCompaniesBySize(size)
• getCompaniesByBusinessModel(model)
• getCompaniesByNeighborhood(neighborhood)
• getCompaniesByCity(city)
• getCompaniesFromRecife()
• getCompaniesFromBairroDoRecife()
• getStartups()
• getCompaniesWithWebsite()

Métodos de getCompanyById(id)

Quando você usa:

const company = getCompanyById(3134);

Você pode chamar:

company.all();
company.createMapsLink();
company.id();
company.name();
company.website();
company.city();
company.business();
company.address();
company.fields(["id", "name"]);

Exemplo completo

import {
  getAllCompanys,
  getCompanyById,
  searchCompanyFields,
  getCompaniesByTechnology,
  getStats
} from "porto-digital-companies";

console.log("Todas as empresas:");
console.log(getAllCompanys());

console.log("Empresa por ID:");
const company = getCompanyById(3134);

console.log(company.name());
console.log(company.website());
console.log(company.createMapsLink());

console.log("Campos específicos:");
console.log(
  company.fields([
    "id",
    "name",
    "contact.website",
    "address.city"
  ])
);

console.log("Busca com campos específicos:");
console.log(
  searchCompanyFields("web", [
    "id",
    "name",
    "technologies"
  ])
);

console.log("Empresas com Web:");
console.log(getCompaniesByTechnology("Web"));

console.log("Estatísticas:");
console.log(getStats());

Aviso

Este pacote não é oficial do Porto Digital.

Os dados são baseados em informações públicas disponíveis no diretório de empresas embarcadas. Use com responsabilidade e confira as informações diretamente na fonte oficial quando necessário.

Licença

MIT